zhenkunhang.item_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=AH0990

参数说明：num_iid:商品ID

响应参数

Version: Date:

名称

类型

必须

示例值

描述

item

item[]

1

 

宝贝详情数据

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/zhenkunhang/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=AH0990"

响应示例

{
"item": {
"detail_url": "https://www.zkh.com/item/AH0990.html?",
"crumbs": "",
"title": "AMMEX/爱马斯 一次性深蓝色丁腈手套 APFNCHD44100 M 无粉麻面 1盒",
"desc_short": "",
"model": "APFNCHD44100",
"starting_batch": "1",
"minimum_packaging": "1",
"brandId": "",
"specifications": "100只/盒 10盒/箱",
"cid": "-1",
"feature": "",
"pic_url": "https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_01.jpg?x-oss-process=style/common_style_600&timestamp=1673462318000",
"item_imgs": {
"url": "https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_01.jpg?x-oss-process=style/common_style_600&timestamp=1673462318000"
},
"nick": "",
"num": 200,
"num_iid": "AH0990",
"price": "40.90",
"orginal_price": "36.19",
"desc": "

",
"props_list": [],
"seller_info": {
"item_score": "",
"shop_name": "AMMEX/爱马斯",
"title": "AMMEX/爱马斯",
"shop_id": 197570,
"zhuy": "https://www.zkh.com/list/b-197570.html",
"company_name": ""
},
"props": [
{
"name": "箱规",
"value": "100只/盒 10盒/箱"
},
{
"name": "尺码",
"value": "M"
},
{
"name": "颜色",
"value": "深蓝色"
}
],
"desc_img": [
"https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_01.jpg?x-oss-process=style/common_style_600&timestamp=1673462318000",
"https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_02.jpg?x-oss-process=style/common_style_600&timestamp=1673462318000",
"https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_03.jpg?x-oss-process=style/common_style_600&timestamp=1673462318000",
"https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_04.jpg?x-oss-process=style/common_style_600&timestamp=1673462318000",
"https://private.zkh.com/PRODUCT/BIG/BIG_AH0990_05.jpg?x-oss-process=style/common_style_600&timestamp=1673462318000"
],
"props_img": [],
"format_check": "ok",
"sales": 0,
"shop_item": [],
"relate_items": []
},
"error": "",
"secache": "72883b891667bd3a5db39accaabaa32e",
"secache_time": 1685083397,
"secache_date": "2023-05-26 14:43:17",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:37 max:10100 all[98=37+28+33];expires:2030-12-31",
"execution_time": "2.05",
"server_time": "Beijing/2023-05-26 14:43:17",
"client_ip": "106.6.38.178",
"call_args": {
"num_iid": "AH0990"
},
"api_type": "zhenkunhang",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "3.08MB",
"request_id": "gw-3.64705503a711f",
"last_id": "1764784088"
}

异常示例

{
"error": "item-not-found",
"reason": "商品没找到",
"error_code": "2000",
"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": "zhengkunhang",
"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

未知错误

否