cat_get-获得aliexpress分类详情
aliexpress.cat_get
公共参数
请求地址: https://api-gw-4.cn/aliexpress/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版本 |
请求参数
请求参数:cid=0
参数说明:cid:商品分类ID,可以用cid=0来获得所有一级类目
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
id | Int | 0 | 200000875 | 商品分类ID |
name | String | 0 | Novelty & Special Use | 分类名 |
pid | String | 0 | 0 | 父分类ID |
root_id | String | 0 | 0 | 根分类ID |
item | Mix | 0 | {"id": 200001270,"name": "Costumes & Accessories","pid": "200000875","root_id": 0,sub[]} | 子分类id:子分类名称 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/aliexpress/cat_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&cid=0"
响应示例
异常示例
相关资料
错误码解释
状态代码(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 工具
速卖通(AliExpress)是阿里巴巴旗下的国际在线购物平台,主要针对海外买家。如果你想通过API获取速卖通上的分类详情,通常可以使用AliExpress的官方API或相应的第三方服务。具体的API返回值会取决于你使用的API版本和请求类型。
以下是一个假设性的速卖通分类详情API返回值的说明,但请注意,这并非实际的API返回结构,因为速卖通的具体API文档可能不为公众公开。在实际开发中,你应当查阅速卖通官方的API文档以获取确切的信息。
```json
{
"code": 200, // 响应状态码,200表示成功
"message": "Success", // 响应信息,描述请求是否成功
"data": {
"category_id": 12345, // 分类ID
"category_name": "Electronics", // 分类名称
"parent_id": 0, // 父分类ID,如果为顶级分类则通常为0
"subcategories": [ // 子分类列表
{
"category_id": 12346,
"category_name": "Mobile Phones",
"parent_id": 12345
},
// ... 其他子分类
],
"products_count": 500, // 该分类下的产品数量
"description": "Electronics products including mobile phones, computers, and more.", // 分类描述
"image_url": "https://example.com/category_image.jpg" // 分类图片链接
}
}
```
在这个假设性的返回值中,我们获得了以下信息:
- **code** 和 **message**:表示请求是否成功的状态码和信息。
- **data**:包含实际数据的对象。
- **category_id**:分类的唯一标识符。
- **category_name**:分类的名称。
- **parent_id**:分类的父级ID,用于标识分类的层级关系。
- **subcategories**:一个包含子分类对象的数组,每个子分类对象包含其子分类的ID、名称和父级ID。
- **products_count**:该分类下产品的数量。
- **description**:分类的描述信息。
- **image_url**:分类的图片链接,可用于展示分类的图标或背景图片。
请务必参考速卖通官方提供的API文档来获取真实的API返回值说明和参数要求,因为上述内容仅为示意性质。同时,也请确保遵守速卖通平台的使用条款和API调用规则。