全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

商品级联属性信息获取


接口地址: http://api.vv-tool.com/tool/erps/getprops


接口介绍: 获取用户发布产品的规则


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

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

请求参数

名称 类型 必须 示例值 描述
shop_id String true 店铺 ID
market String true taobao 商品发布的市场。taobao:淘宝,tmall:天猫,litetao:淘宝特价版
cat_id Number true 50021288 商品类目 ID
barcode String false 6932529211107 商品条码
schema String true 类目属性渲染 schema
prop_id Number true 20000 属性 ID
vvtype int false 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3

请求示例

cat_id:50021288
market:taobao
schema: 1128204128
prop_id:20000
vvtype:2
shop_id:123

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/getprops' \
--header 'Authorization: Bearer 922c7c375f003f13fc2ba8XXXXXXXXXXXXX' \
--form 'cat_id="50021288"' \
--form 'market="taobao"' \
--form 'schema="<itemSchema> <field id=\"catProp\" name=\"类目属性\" type=\"complex\"> <complex-value> <field id=\"p-20000\" name=\"品牌\" type=\"singleCheck\"> <value>1128204128</value> </field> </complex-value> <fields> <field id=\"p-20000\" name=\"品牌\" type=\"singleCheck\"> </field> </fields> </field></itemSchema>"' \
--form 'prop_id="20000"' \
--form 'vvtype="2"' \
--form 'shop_id="123"'

PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/getprops',
  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('cat_id' => '50021288','market' => 'taobao','schema' => '<itemSchema> <field id="catProp" name="类目属性" type="complex"> <complex-value> <field id="p-20000" name="品牌" type="singleCheck"> <value>1128204128</value> </field> </complex-value> <fields> <field id="p-20000" name="品牌" type="singleCheck"> </field> </fields> </field></itemSchema>','prop_id' => '20000','vvtype' => '2','shop_id' => '123'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 922c7c375f003f13fc2ba8XXXXXXXXXXXXX',
    'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=749f3109d17e870ee119d418de62158d; _csrf=32285aac233cafec17547f533b10497fbc3bfc321401a95c87197b6090f94aada%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22uFfDqxmqnRiMlJvsKQjEf6VeC7oWRoWY%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("cat_id","50021288")
  .addFormDataPart("market","taobao")
  .addFormDataPart("schema","<itemSchema> <field id=\"catProp\" name=\"类目属性\" type=\"complex\"> <complex-value> <field id=\"p-20000\" name=\"品牌\" type=\"singleCheck\"> <value>1128204128</value> </field> </complex-value> <fields> <field id=\"p-20000\" name=\"品牌\" type=\"singleCheck\"> </field> </fields> </field></itemSchema>")
  .addFormDataPart("prop_id","20000")
  .addFormDataPart("vvtype","2")
  .addFormDataPart("shop_id","123")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/getprops")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 922c7c375f003f13fc2ba8XXXXXXXXXXXXX")
  .addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=749f3109d17e870ee119d418de62158d; _csrf=32285aac233cafec17547f533b10497fbc3bfc321401a95c87197b6090f94aada%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22uFfDqxmqnRiMlJvsKQjEf6VeC7oWRoWY%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 示例值 描述
result SellerAuthorize 商品发布规则信息,XML 格式。
withholding_money int 11 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": {
        "withholding_money": 1,
        "result":"<itemSchema> <field id=\"title\" name=\"宝贝标题\" type=\"input\"> <rules> <rule name=\"tipRule\" value=\"标题和描述关键词是否违规自检工具:&lt;a href='\/\/ss.taobao.com\/compliance#\/main' target='_blank'&gt;商品合规工具&lt;\/a&gt;\"\/> <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>"
    
        }

}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权
401 身份凭证无效 在请求头中添加 access_token
614 系统繁忙,请稍后重试 系统繁忙,请稍后重试