全部
在线测试
卡首屏系列
接口地址： 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、30 需要必传 |
| url | string | 是 | 商品链接/商品 id 如：600804559767 |
| type | string | 是 | 请求类型 1:手淘推荐、2:手淘清仓流量、3:手淘网红集合、4:生活研究所、5:中国制造、6:品牌捡漏、7:换新、8:汇吃、9:找相似入口、10:有好货入口、11:每日好店入口、12:淘抢购入口、13:亲宝贝入口、14:首页钻展入口、15:iFashion、16:全球购入口、17:洋淘秀、18:小黑盒、19:问大家、20:【聚划算】品牌特卖、21:首单优惠、22:淘金币、23:支付页-猜你喜欢-流量来源手淘推荐、24:购后猜你喜欢、25:手淘旺信卡首屏、26:淘内免费其它（通用版）、27:天天特卖卡首屏、28:买家秀、29:新品推荐、30:红包签到、31:手淘其它商品详情页、32:芭芭农场，33:U 先使用，33:U 先使用，34:天天低价，36:购后推荐，37:淘宝好价，38:手淘直播，39:淘内待分类-通用，40:淘内待分类-精选发现，41:淘内待分类-为你推荐，42:淘内待分类-猜你喜欢，43:手淘推荐 云主题，44:手淘必买清单，45:详情页头图推荐，46:短视频全屏页，47:手淘有好价，48:手淘拍立淘，49:淘宝好货推荐，50:邻家好货手淘（需要填写竞品 ID 和商家自己商品 ID），51:小黑盒卡首屏，52:猜你喜欢小星星，53:首单优惠礼金卡首屏，56:淘宝吃货，57:惠生活，59:潮玩世界，60:潮店数码，62:踏秋季，63:节日指南，64:潮玩节，65:趣玩季，66:多巴胺，67:爱宠日，68:冰雪节，69:情人节，73:每平每屋，74:我的萌宠，75:喵鲜生，76:潮 WOO，77:酷玩星球，78:海外直购，79:全球购，84:家装好物，111:天猫国际，112:天猫 U 先，113:天猫奢品，114:天猫果粉，116:天猫榜单，117:天猫造新 如：2 |
| label | string | 否 | 标签：如请求类型为 4 则该字段为必传，否则将报错，请求其他类型时不需填写该字段点击查看标签详情 |
| main_url1 | string | 否 | 其他商品链接/商品 1 id 如：600804559767 请求类型为 31、50 则该字段为必传，否则将报错 |
| main_url2 | string | 否 | 其他商品链接/商品 2 id 如：600804559767 请求类型为 31 则该字段为必传，否则将报错(main_url1,main_url2 俩传其一，或都传) |
| buyers_id | string | 否 | 买家秀 id 如请求类型为 28 则该字段为必传，否则将报错，传该字段可以不传 url 字段 |
| wangwang | string | 否 | 掌柜旺旺 如请求类型为 25 则该字段为必传，否则将报错 |
请求示例
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 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |