|
taobao.itemprops.list.get API功能描述 | |
| 此接口方法以实现得到前台展示的供买家浏览的商品属性。 |
|
taobao.itemprops.list.get API调用级别 | |
| apiType=1， 需要签名校验(不需用户绑定) |
|
taobao.itemprops.list.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 version="1.0" encoding="utf-8" | |
| XML数据格式 | JSON数据格式(暂不支持) |
| <?xml version="1.0" encoding="utf-8"?> <rsp> <item_prop> <pid>10006</pid> <name>诺基亚型号</name> <prop_values> <prop_value> <vid>10086</vid> <name>1100</name> </prop_value> <prop_value> <vid>10059</vid> <name>1108</name> </prop_value> </prop_values> </item_prop> </rsp> |
{"item_prop":{"pid":"10006","name":"诺基亚型号"， "prop_values":{"prop_value":{"vid":"10086","name":"1100"}， "prop_value":{"vid":"10059","name":"1108"}}}} |
| 返回信息 | 返回信息说明 |
| pid | 属性id |
| name | 属性名 | |
| prop_values | 属性值列表 |
| 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.list.get 接口调用实例 |
|
历史版本 | |
| 版本号 | 说明 |
| 1.0 |