全部
在线测试

卡首屏系列


接口地址: http://api.vv-tool.com/tool/accounts/card-first-screen


接口介绍: 通过该接口生成链接下单点击查看详情


请求方式: POST


传参格式: form-data


返回格式: JSON


接口收费: 生成 1 次,计 1 次调用,联系销售可以拿到低价


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请使用新的生成 token 接口 点击查看详情

请求参数

参数 类型 必选 描述
keyword string 商品标题 类型 9 需要必传
url string 商品链接/商品 id 如:600804559767
type string 请求类型 1:手淘推荐、2:手淘清仓流量、3:手淘网红集合、4:生活研究所、5:中国制造、6:品牌捡漏、7:换新、8:汇吃、9:找相似入口、10:有好货入口、11:每日好店入口、12:淘抢购入口、13:亲宝贝入口、14:首页钻展入口、15:iFashion、16:全球购入口、17:洋淘秀, 如:2
label string 标签:如请求类型为 4 则该字段为必传,否则将报错,请求其他类型时不需填写该字段点击查看标签详情

请求示例

keyword:迷你湿巾
url:623917802188
type:2

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/accounts/card-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/accounts/card-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/accounts/card-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 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确