item_cat_get-获得淘宝商品类目
taobao.item_cat_get
公共参数
请求地址: https://api-gw-4.cn/taobao/item_cat_get
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:num_iid=520813250866
参数说明:num_iid:淘宝商品ID
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid | Bigint | 0 | 520813250866 | 宝贝ID |
item_name | String | 0 | 三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮 | 宝贝标题 |
item_url | String | 0 | http://item.taobao.com/item.htm?id=520813250866 | 宝贝网址 |
cat_id | Bigint | 0 | 50014822 | 分类ID |
root_cat_id | Bigint | 0 | 50013886 | 顶级分类ID |
cat_name | String | 0 | 多功能组合工具 | 分类名称 |
root_cat_name | String | 0 | 户外/登山/野营/旅行用品 | 顶级分类名称 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/taobao/item_cat_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=520813250866"
响应示例
异常示例
相关资料
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
API 工具
淘宝/天猫的开放平台(以前称为淘宝开放平台,现统称为阿里巴巴开放平台)为开发者提供了许多API接口,允许开发者访问并整合淘宝/天猫的商品、订单、用户等数据。对于淘宝商品类目API,你通常会得到关于商品所属类目的详细信息。
以下是可能返回的API返回值字段的示例和描述:
1. **cid**:类目ID,每个类目都有一个唯一的数字ID。
2. **name**:类目名称,如“女装”、“手机”等。
3. **parent_cid**:父类目ID,表示该类目所属的上级类目。例如,“女装”可能是“服装”类目的子类目。
4. **is_leaf**:是否叶子类目。如果是叶子类目,那么该类目下不再有其他子类目。
5. **level**:类目层级。例如,根类目可能是1级,而更具体的子类目可能是2级、3级等。
6. **children**:子类目列表。如果该类目有子类目,那么这个字段会包含子类目的列表。
7. **is_root**:是否为根类目。如果是根类目,那么它没有父类目。
8. **path**:类目路径,通常用于表示该类目在整个类目树中的位置。
9. **product_count**:该类目下的商品数量。
请注意,这些只是可能的返回值字段。具体的API返回值取决于你调用的具体API接口和版本。为了获得最准确和最新的信息,你应该查看阿里巴巴开放平台的官方文档,该文档通常会详细列出每个API的返回值字段、数据类型和描述。
如果你需要具体的API调用示例或代码,也可以告诉我,我会尽量提供帮助。