|
taobao.itemprops.get API功能描述 | |
| 此接口方法以实现得到后台供卖家发布商品用的商品标准属性和属性值列表。 |
|
taobao.itemprops.get API调用级别 | |
| apiType=2， 所有的服务调用，需要签名校验和用户绑定 |
|
taobao.itemprops.get API调用参数 | |
| 系统级参数 |
| sip_appkey | String | 必须 | ISV应用的appkey为软件互联平台分配给ISV应用的唯一编号。 |
| sip_apiname | String | 必须 | 服务名。 |
| sip_timestamp | String | 可选 | 服务请求时间戳(yyyy-mm-dd hh:mi:ss)。 |
| sip_sign | String | 可选 | 请求签名（包括了对前面三个必选参数和所有业务参数按签名规则做签名） |
| sip_format | String | 可选 | 规定返回值的类型。支持两种格式json与xml。默认为xml数据格式。 |
| sip_sessionid | String | 可选 | 在ISV应用中用户会话唯一标识。 |
| v | String | 必须 | 必须设置到1.0来使用这个版本的API。 |
| 应用级参数 |
| 名称 | 类型 | 是否必须 | 描述 |
| cid | String | 必须 | 叶子商品类目id。 |
| pid | String | 可选 | 属性id,不选即请求第一层属性（即商品类目属性） |
|
正常返回格式 | |
| XML数据格式 | JSON数据格式(暂不支持) |
| <?xml version="1.0" encoding="utf-8"?> <rsp> <item_prop> <pid>20879</pid> <name>成色</name> <must>true</must> <prop_values> <prop_value> <vid>32559</vid> <name>9成新</name> </prop_value> <prop_value> <vid>32557</vid> <name>9.9成新</name> </prop_value> </prop_values> </item_prop> <item_prop> <pid>10005</pid> <name>品牌</name> <must>true</must> <prop_values> <prop_value> <vid>10027</vid> <name>诺基亚</name> <child_pid>10006</child_pid> </prop_value> <prop_value> <vid>10123</vid> <name>摩托罗拉</name> <child_pid>10007</child_pid> </prop_value> </prop_values> </item_prop> <item_prop> <pid>21514</pid> <name>手机价格区间</name> <prop_values> <prop_value> <vid>42370</vid> <name>1000元以下</name> </prop_value> <prop_value> <vid>38489</vid> <name>1001-2000元</name> </prop_value> </prop_values> </item_prop> </rsp> |
{"item_prop":{"pid":"20879","name":"成色"，"must":"true","prop_values":{"prop_value":{"vid":"325559","name":"9成新"}，"prop_value":{"vid":"32557","name":"9.9成新"}}},"item_prop":{"pid":"10005","name":"品牌"，"must":"true","prop_values":{"prop_value":{"vid":"10027","name":"诺基亚"，"child_pid":"10006"}，"prop_value":{"vid":"10123","name":"摩托罗拉"，"child_pid":"10007"}}}，"item_prop":{"pid":"21514","name":"手机价格区间"，"prop_values":{"prop_value":{"vid":"42370","name":"1000元以下"}，"prop_value":{"vid":"38489","name":"1001-2000元"}}}} |
| 返回信息 | 返回信息说明 |
| pid | 属性id |
| name | 属性名 |
| must | 发布商品时是否必选子属性 |
| child_pid | 子属性id |
| propvalues | 属性值列表 |
| propvalue | 属性值 |
| vid | 属性值id |
|
异常返回格式 | |
| 系统级异常 |
| XML数据格式 | JSON数据格式(暂不支持) |
| <?xml version="1.0" encoding="utf-8" ?> <error_rsp> <code>error-code</code> <msg>error-message</msg> </error_rsp> |
{"code":"error-code","msg":"error-message"} |
| 错误码 | 错误描述 | 说明 |
| 8 | Call limited | 呼叫受限，目前指对用户隐私数据的请求频率异常。 |
| 9 | Http action not allowed | 该方法不允许使用此Http动作 |
| 10 | Service currently navailable | 服务不可用 |
| 11 | Insufficient ISV permissions | 第三方程序权限不够 |
| 12 | Insufficient user ermissions | 用户权限不够 |
| 21 | Missing Method | 方法丢失 |
| 22 | Invalid Method | 方法无效 |
| 23 | Invalid Format | 响应格式无效 |
| 24 | Missing signature | 签名丢失 |
| 25 | Invalid signature | 签名无效 |
| 26 | Missing session | 会话期识别码丢失 |
| 27 | Invalid session | 会话期识别码无效 |
| 28 | Missing API Key | sip_appkey丢失 |
| 29 | Invalid API Key | sip_appkey无效 |
| 30 | Missing timestamp | 时间戳丢失 |
| 31 | Invalid timestamp | 时间戳无效 |
| 32 | Missing version | 版本丢失 |
| 33 | Invalid version | 版本错误 |
| 40 | Missing required arguments | 参数丢失，指除
sip_apiname,sip_appkey,sip_sign,sip_timestamp，sip_sessionid,sip_format,v 外的其他参数丢失 |
| 41 | Arguments wrong format | 参数格式错误, 指参数格式不满足约定 |
|
范例 | |
taobao.itemprops.get 接口调用实例 |
|
历史版本 | |
| 版本号 | 说明 |
| 1.0 |