淘宝标准商品类目查询
标识:ItemCatsGet
- 接口地址:
https://way.jd.com/TONGLI/ItemCatsGet
- 请求方式:
HTTPS GET POST
- 请求示例:
https://way.jd.com/TONGLI/ItemCatsGet?cids=150704&fields=cid,parent_cid,name,is_parent,status,sort_order,features,taosir_cat,last_modified&appkey=您申请的APPKEY
QUERY请求参数
- 公共请求参数
-
名称 类型 必填 示例值 描述 appkey String 是 1 您申请的appkey - 业务请求参数
-
名称 类型 必填 示例值 描述 cids String 否 150704 商品所属类目ID列表,用半角逗号(,)分隔 例如:(18957,19562,) (cids、parent_cid至少传一个) fields String 否 cid,parent_cid,name,is_parent,status,sort_order,features,taosir_cat,last_modified 需要返回的字段列表,见ItemCat,默认返回:cid,parent_cid,name,is_parent;增量类目信息,根据fields传入的参数返回相应的结果。 features字段: 1、如果存在attr_key=freeze表示该类目被冻结了,attr_value=0,5,value可能存在2个值(也可能只有1个),用逗号分割,0表示禁编辑,5表示禁止发布 parent_cid String 否 父商品类目id,0表示根节点, 传输该参数返回所有子类目。 (cids、parent_cid至少传一个)
返回参数
- 公共返回参数
-
名称 类型 示例值 描述 code string 10000 更多返回参数示例值请参看“错误参照码” charge boolean false 或 true false:不扣费 true:扣费 remain long 1305 数据剩余次数 msg string 查询成功 更多返回参数示例值请参看“错误参照码” result object {...} 数据查询结果 - 业务返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ret_id | number | 131975170556544511 | 请求ID |
ret_body | string | {"item_cats":{"item_cat":[{"cid":150704,"is_parent":false,"name":"手机保护套/壳","parent_cid":50024094,"sort_order":0,"status":"normal","taosir_cat":false}]},"request_id":"lptbrpvnwtlp"} | 返回内容 |
ret_message | string | 错误信息 | |
ret_code | number | 0 | 错误代码 |
返回示例值
{"code":"10000","charge":false,"remain":1305,"msg":"查询成功","result":{"ret_code":0,"ret_message":"","ret_body":"{\"item_cats\":{\"item_cat\":[{\"cid\":150704,\"is_parent\":false,\"name\":\"手机保护套/壳\",\"parent_cid\":50024094,\"sort_order\":0,\"status\":\"normal\",\"taosir_cat\":false}]},\"request_id\":\"lptbrpvnwtlp\"}","ret_id":131975170556544511}}