本文详细介绍了1688电商平台提供的商品类目API接口，包括公共参数、请求地址、接口名称、参数说明、响应参数示例以及常见错误处理。开发者可以使用这些接口获取商品详情、搜索商品、店铺信息等数据。
1688提供了同行还在看接口 1688商品类目的API接口，具体如下：
公共参数
请求地址：前往测试
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
此API目前支持以下基本接口：
item_get 获得1688商品详情
item_search 按关键字搜索商品
item_search_img 按图搜索1688商品（拍立淘）
item_search_suggest 获得搜索词推荐
item_fee 获得商品快递费用
seller_info 获得店铺详情
item_search_shop 获得店铺的所有商品
item_password 获得淘口令真实url
upload_img 上传图片到1688
item_search_seller 搜索店铺列表
img2text 图片识别商品接口
item_get_app 获取1688app上原数据
buyer_order_list 获取购买到的商品订单列表
cat_get 获得1688商品分类
请求参数
请求参数：num_iid=610947572360
参数说明：num_iid:1688商品ID
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | item[] | 0 | 获得1688商品类目 |
响应示例
{
"item": {
"num_iid": "610947572360",
"item_name": "官网Qin2 pro多亲AI手机戒网瘾学生机智能助手同学防沉迷4G手机",
"item_url": "https://detail.1688.com/offer/610947572360.html",
"cat_id": "50903",
"root_cat_id": "7",
"cat_name": {
"itme": {
"id": "50903",
"name": "智能手机",
"pid": "728",
"root_id": "728",
"sub": []
}
},
"root_cat_name": {
"itme": {
"id": "7",
"name": "数码、电脑",
"pid": 0,
"root_id": 0,
"sub": [
{
"id": 123754001,
"name": "智能设备",
"pid": "7",
"root_id": 0,
"sub": [
{
"id": 121624001,
"name": "智能手表",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123756001,
"name": "智能手环",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124580001,
"name": "智能影音",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124734030,
"name": "智能插座",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124744046,
"name": "智能路由器",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124744043,
"name": "智能排插",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124736056,
"name": "MID电话机",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124744047,
"name": "智能摄像机",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124740027,
"name": "智能家教机",
"pid": 123754001,
"root_id": "7"
},
{
"id": 1037157,
"name": "智能网络设备",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124582001,
"name": "智能安防监控",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124734031,
"name": "智能投影仪",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123756003,
"name": "智能手镯",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123650001,
"name": "智能防丢器",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123760002,
"name": "智能计步器",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123648002,
"name": "智能遥控器",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123860004,
"name": "智能耳机",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123752002,
"name": "智能跟踪器",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123758005,
"name": "智能体重秤",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123752003,
"name": "智能戒指",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123736004,
"name": "智能项链",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124902001,
"name": "智能按摩贴",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123758003,
"name": "智能眼镜",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123758004,
"name": "智能头箍",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123736005,
"name": "智能钱包",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123754004,
"name": "智能标签、名片",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124904002,
"name": "智能夹子",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124908001,
"name": "智能挂锁",
"pid": 123754001,
"root_id": "7"
},
{
"id": 124906001,
"name": "智能眼罩",
"pid": 123754001,
"root_id": "7"
},
{
"id": 123736006,
"name": "智能肌肤测试仪",
"pid": 123754001,
"root_id": "7"
异常示例
{
"error": "data error",
"reason": "data error",
"error_code": "5000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "1688",
"request_id": "15ee0ffc041242"}
相关资料
错误码解释
| 状态代码(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 | 未知错误 | 否 |
扫一扫
2702
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
