全部
在线测试
关键词卡首屏 API
接口地址: http://api.vv-tool.com/tool/conversions/first-screen
接口介绍: 通过该接口生成链接下单,生意参谋后台显示手淘搜索(搜索词指定搜索词)下单 点击查看详情
请求方式: POST
传参格式: form-data
返回格式: JSON
接口收费: 包年包月
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
keyword | string | 是 | 商品搜索词 如:眼影 |
url | string | 是 | 商品链接/商品 id 如:600804559767 |
type | string | 否 | 请求类型 1:普通版、2:高级版,默认为 1 如:2 |
请求示例
keyword:迷你湿巾
url:623917802188
type:2
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/conversions/first-screen' \
--header 'Authorization: Bearer c2c20409e5f3f34437aece02c69b9a9dxxxxxxxx' \
--header 'Cookie: PHPSESSID=8gk3dcemg4j0o1qbol21pjkits; _csrf=5306f9747cabb278ff1cb08b1c1056537bef9c2a343d77d10336c874eeb4b0eba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22ThwPd5A0gHmm4Td6MlihizBEcjga8Zsh%22%3B%7D' \
--form 'keyword=湿巾' \
--form 'url=623917802188'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "http://api.vv-tool.com/tool/conversions/first-screen",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('keyword' => '湿巾','url' => '623917802188'),
CURLOPT_HTTPHEADER => array(
"Authorization: Bearer c2c20409e5f3f34437aece02c69b9a9dxxxxxxxx",
"Cookie: PHPSESSID=8gk3dcemg4j0o1qbol21pjkits; _csrf=5306f9747cabb278ff1cb08b1c1056537bef9c2a343d77d10336c874eeb4b0eba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22ThwPd5A0gHmm4Td6MlihizBEcjga8Zsh%22%3B%7D"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
.addFormDataPart("keyword", "湿巾")
.addFormDataPart("url", "623917802188")
.build();
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/conversions/first-screen")
.method("POST", body)
.addHeader("Authorization", "Bearer c2c20409e5f3f34437aece02c69b9a9dxxxxxxxx")
.addHeader("Cookie", "PHPSESSID=8gk3dcemg4j0o1qbol21pjkits; _csrf=5306f9747cabb278ff1cb08b1c1056537bef9c2a343d77d10336c874eeb4b0eba%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22ThwPd5A0gHmm4Td6MlihizBEcjga8Zsh%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
参数 | 类型 | 描述 |
---|---|---|
code | int | 返回状态码 |
msg | string | 返回码描述 |
msec | int | 接口执行时间 |
time | int | 接口返回时间 |
data | string | 卡首屏地址 |
返回数据
{
"code": 0,
"msg": "成功",
"msec": 13,
"time": 1576402871,
"data": "https://s.m.taobao.com/h5?q=%E5%A5%B3%E7%A5%9E%E7%9C%BC%E5%BD%B1&showtype=similar&graphnid=600804559767&ut_sk=1.utdid_23782382_1545636334773.Copy.shoutaosearch"
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
401 | 身份凭证无效 | 在请求头中添加 access_token,重新更新 token |
404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |