全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取商品发布规则信息
接口地址: http://api.vv-tool.com/tool/erps/schemaget
接口介绍: 新商品发布,获取商品发布规则信息
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
shop_id | String | true | 店铺 ID | |
biz_type | String | false | taobao/1.0.0/brandAsyncRenderEnable | 业务扩展参数,需与平台约定好 |
images | String[] | false | 商品主图链接,最多 5 张,传入完整 URL | |
item_type | String | false | b | 商品类型。b:一口价 a:拍卖 默认值 b 一口价 |
market | String | true | taobao | 商品发布的市场。taobao:淘宝,tmall:天猫,litetao:淘宝特价版 |
cat_id | Number | true | 50021288 | 商品类目 ID |
spu_id | Number | false | 32323 | 产品 ID,天猫市场(market=tmall)时必填 |
barcode | String | false | 6932529211107 | 商品条码 |
vvtype | Number | false | 1 | 2 高级版(必须填 2,不填默认是 2) |
请求示例
shop_id:123
cat_id:50021288
market:taobao
vvtype:2
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/schemaget' \
--header 'Authorization: Bearer 2b43e6dd317c80b5617082dXXXXXXXXXXXXX' \
--form 'shop_id="123"' \
--form 'cat_id="50021288"' \
--form 'market="taobao"' \
--form 'vvtype="2"'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/schemaget',
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('shop_id' => '123','cat_id' => '50021288','market' => 'taobao','vvtype' => '2'),
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer 2b43e6dd317c80b5617082dXXXXXXXXXXXXX'
),
));
$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("shop_id","123")
.addFormDataPart("cat_id","50021288")
.addFormDataPart("market","taobao")
.addFormDataPart("vvtype","2")
.build();
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/erps/schemaget")
.method("POST", body)
.addHeader("Authorization", "Bearer 2b43e6dd317c80b5617082dXXXXXXXXXXXXX")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | String | 商品发布规则信息,XML 格式。 | |
withholding_money | int | 11 | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1460,
"time": 1617273033,
"data": {
"result":"<itemSchema> <field id=\"title\" name=\"宝贝标题\" type=\"input\"> <rules> <rule name=\"tipRule\" value=\"标题和描述关键词是否违规自检工具:<a href='\/\/ss.taobao.com\/compliance#\/main' target='_blank'>商品合规工具<\/a>\"\/> <rule name=\"requiredRule\" value=\"true\"\/> <rule exProperty=\"include\" name=\"maxLengthRule\" unit=\"byte\" value=\"60\"\/> <rule name=\"tipRule\" value=\"最多允许输入30个汉字(60字符)\"\/> <rule name=\"valueTypeRule\" value=\"text\"\/> <\/rules> <\/field> <field id=\"supplierInfo\" name=\"供应商信息\" type=\"input\"> <rules> <rule name=\"requiredRule\" value=\"true\"\/> <rule exProperty=\"include\" name=\"maxLengthRule\" unit=\"byte\" value=\"40\"\/> <rule name=\"valueTypeRule\" value=\"text\"\/> <\/rules> <\/field> <field id=\"outerId\" name=\"商家编码\" type=\"input\"> <rules> <rule exProperty=\"include\" name=\"maxLengthRule\" unit=\"byte\" value=\"64\"\/> <rule name=\"valueTypeRule\" value=\"text\"\/> <\/rules> <\/field> <\/itemSchema>",
"withholding_money": 1
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |
401 | 身份凭证无效 | 在请求头中添加 access_token |
614 | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |