京东JD商品详情API是一个重要的工具,它允许开发者从京东平台上获取商品的详细信息。以下是关于京东JD商品详情API返回值的分析,旨在帮助提升商品信息获取效率:
-
返回值结构:
- 当你成功调用京东JD商品详情API后,会收到一个包含商品详细信息的JSON格式的返回值。JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,易于人阅读和编写,同时也易于机器解析和生成。
- 在这个JSON返回值中,每个字段都由一个键(key)和一个值(value)组成,键和值之间用冒号分隔,不同的字段之间用逗号分隔。
-
主要返回值字段:
- 商品标题:商品的名称或标题,用于展示给用户,帮助用户了解商品的基本信息。
- 商品价格:商品的销售价格,包括原价、促销价等,对用户的购物决策具有重要意义。
- 商品图片:商品的图片链接或URL,开发者可以通过这些链接获取商品的图片,用于展示给用户或进行其他操作。
- 商品规格:商品的详细规格信息,如尺寸、颜色、材质等,有助于用户了解商品的具体参数。
- 商品参数:商品的附加参数信息,如品牌、产地、保修期等,进一步丰富用户对商品的了解。
- 店铺信息:商品所属店铺的相关信息,如店铺名称、店铺评分等,有助于用户了解商家的信誉和服务质量。
-
如何提升商品信息获取效率:
- 了解API文档:首先,深入阅读并理解京东官方提供的JD商品详情API文档,确保你清楚每个参数的作用和返回值的含义。
- 优化请求参数:根据实际需求,优化请求参数,如只获取你关心的字段信息,避免返回冗余数据。
- 使用合适的编程语言和库:选择你熟悉的编程语言和库来处理JSON数据,可以大大提高数据处理的效率。
- 缓存策略:对于频繁访问且数据变动不大的商品信息,可以考虑使用缓存策略,减少不必要的API调用。
- 错误处理和重试机制:实现完善的错误处理和重试机制,确保在网络波动或API故障时,能够自动重试或给出明确的错误提示。
- 并行处理:如果需要获取多个商品的信息,可以考虑使用并行处理的方式,同时发起多个API请求,以加快数据处理速度。
jd.item_get
公共参数
请求地址: https://api-gw.onebound.cn/jd/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=10335871600
参数说明:num_iid:JD商品ID
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | item[] | 0 | 获得JD商品详情 |
响应示例
"item": {
"num_iid": "100061393554",
"title": "回力外套男连帽开衫卫衣男春秋季潮流宽松休闲简约高街针织运动上衣",
"desc_short": "",
"price": 99,
"total_price": "",
"suggestive_price": "",
"orginal_price": 99,
"nick": "回力服饰京东自营旗舰店",
"num": 2400,
"detail_url": "https://item.jd.com/100061393554.html",
"pic_url": "http://img13.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg",
"brand": "回力",
"brandId": "",
"rootCatId": "",
"cid": 9732,
"desc": "<img src=\"http://img30.360buyimg.com/sku/jfs/t1/141528/9/38969/148435/64f9daa3F47ad4db1/1f70c526189c7b0a.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/86458/36/42802/42878/64f9daa3F0f3c32ed/2c1f5f38c34417f5.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/108848/9/42926/31906/64f9daa3F9a3a76f6/ebcef65f6cd4dcc2.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/116390/24/42377/66764/64f9daa3Fe2819550/6c8bebe5f123ab1e.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/97506/30/32691/48491/64f9daa3Ff13fc8d6/28981ecfac62a699.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/172839/6/40006/52968/64f9daa3Fc685c70c/c27ba345b1d2e633.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/187653/28/37655/76702/64f9daa3F98b3ddc9/2249b4c88c638d37.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/102767/37/38077/131849/64f9daa3F56a039ec/8d3ad5cc32e44b82.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/46794/36/27461/108749/64f9daa3Fbc6530e6/a386b772c539a9ca.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/189583/15/40332/109556/652e3579F2172cb50/9af850e5930e29d7.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/140302/14/40517/88372/64f9daa3F66ddc57f/36793a81c9dcc236.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/235758/38/36/59760/652e3348F66bd14ac/81e9313cd4a90169.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/178474/30/37529/94689/64f9daa3Fde599f7a/ee302d1e087c1a13.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/178138/32/36857/299260/64f9daa3F3de29b1b/65db1bd588134e4e.jpg\" /><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.65f7a44a42484&p=1778787634&k=i_key&t=1710728267\" style=\"display:none\" />",
"item_imgs": [
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/203326/26/40643/58766/64f9d9bdF42d299d2/c63a7a1e2d733d9b.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/6009/33/22617/70571/64e88b13F0e150eff/ac19e310c2a05b18.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/139357/10/38389/58281/64ce1317F463fc9a5/22ebdb9d5324f434.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/96651/35/40854/75683/64ce1317F666a7db3/08355c841c27427b.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/93068/25/41957/117547/64ce1317F161a9be8/0c728de179b4c4ff.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/196684/19/35713/46717/64ce1317F67ca16e5/5390ae8d8603a4a2.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/199352/3/38942/38665/64ce1317F50c7bacd/2b0098766af6c0fe.jpg"
},
{
"url": "http://img13.360buyimg.com/n12/jfs/t1/93213/19/40402/77871/64ce1318F9d7ecfef/f0841c6e94c3c4bb.jpg"
}
],
"item_weight": "",
"post_fee": "",
"freight": "",
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"video": {
"url": "https://jvod.300hu.com/vod/product/64f404d7-7400-47d5-aa5a-14344773cfd1/f88d6b0d860a4f49b6df21e30cdbfeb9.mp4?source=2&h265=h265/113074/31caa5da0c77447cabe97ebf3db02125.mp4"
},
"sample_id": "",
"props_name": "47876:47982:尺码:M/158-165(建议95-110斤);47876:48224:尺码:L/165-170(建议111-125斤);47876:48347:尺码:XL/170-175(建议126-140斤);47876:51182:尺码:2XL/170-175(建议141-155斤);47876:51290:尺码:3XL/175-180(建议156-165斤);47876:51415:尺码:4XL/178-183(建议166-175斤);47876:47982:尺码:M/158-165(建议95-110斤);47876:48224:尺码:L/165-170(建议111-125斤);47876:48347:尺码:XL/170-175(建议126-140斤);47876:51182:尺码:2XL/170-175(建议141-155斤);47876:51290:尺码:3XL/175-180(建议156-165斤);47876:51415:尺码:4XL/178-183(建议166-175斤);47876:48224:尺码:L/165-170(建议111-125斤);47876:51182:尺码:2XL/170-175(建议141-155斤);47876:51415:尺码:4XL/178-183(建议166-175斤);47876:48347:尺码:XL/170-175(建议126-140斤);47876:51182:尺码:2XL/170-175(建议141-155斤);47876:48224:尺码:L/165-170(建议111-125斤);47876:51290:尺码:3XL/175-180(建议156-165斤);47876:51415:尺码:4XL/178-183(建议166-175斤);47876:47982:尺码:M/158-165(建议95-110斤);47876:51290:尺码:3XL/175-180(建议156-165斤);47876:47982:尺码:M/158-165(建议95-110斤);47876:48347:尺码:XL/170-175(建议126-140斤);47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:52484:颜色:黑色加绒;47918:53298:颜色:灰色加绒;47918:52484:颜色:黑色加绒;47918:52484:颜色:黑色加绒;47918:52484:颜色:黑色加绒;47918:53298:颜色:灰色加绒;47918:53298:颜色:灰色加绒;47918:53298:颜色:灰色加绒;47918:52484:颜色:黑色加绒;47918:52484:颜色:黑色加绒;47918:53298:颜色:灰色加绒;47918:53298:颜色:灰色加绒",
"prop_imgs": {
"prop_img": [
{
"properties": "47918:47989",
"url": "http://img10.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg"
},
{
"properties": "47918:51511",
"url": "http://img10.360buyimg.com/n12/jfs/t1/178926/26/41818/105748/65434809F4c0c9310/f2fe554054c0300a.jpg"
},
{
"properties": "47918:52484",
"url": "http://img10.360buyimg.com/n12/jfs/t1/128712/20/41487/68673/6512c9b7Fffbd23b0/0b74cb3de4d04609.jpg"
},
{
"properties": "47918:53298",
"url": "http://img10.360buyimg.com/n12/jfs/t1/9850/34/22290/106675/6512ca04F6c6da0b7/6c13cf40109e35fb.jpg"
}
]
},
"props_imgs": {
"prop_img": [
{
"properties": "47918:47989",
"url": "http://img10.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg"
},
{
"properties": "47918:51511",
"url": "http://img10.360buyimg.com/n12/jfs/t1/178926/26/41818/105748/65434809F4c0c9310/f2fe554054c0300a.jpg"
},
{
"properties": "47918:52484",
"url": "http://img10.360buyimg.com/n12/jfs/t1/128712/20/41487/68673/6512c9b7Fffbd23b0/0b74cb3de4d04609.jpg"
},
{
"properties": "47918:53298",
"url": "http://img10.360buyimg.com/n12/jfs/t1/9850/34/22290/106675/6512ca04F6c6da0b7/6c13cf40109e35fb.jpg"
}
]
},
"property_alias": "",
"props": [
{
"name": "商品名称",
"value": "回力男士卫衣"
},
{
"name": "商品编号",
"value": "100061393554"
},
{
"name": "商品毛重",
"value": "500.00g"
},
{
"name": "商品产地",
"value": "中国大陆"
},
{
"name": "货号",
"value": "LA311A81005"
},
{
"name": "材质",
"value": "涤纶(聚酯纤维)93.6%,氨纶(聚氨酯弹性纤维)6.4%"
},
{
"name": "版型",
"value": "宽松型"
},
{
"name": "适用季节",
"value": "春季,秋季"
},
{
"name": "上市时间",
"value": "2023年秋季"
},
{
"name": "领型",
"value": "连帽"
},
{
"name": "适用人群",
"value": "青少年,青年"
},
{
"name": "流行元素",
"value": "印花"
},
{
"name": "袖型",
"value": "常规袖"
},
{
"name": "厚度",
"value": "常规"
},
{
"name": "风格",
"value": "百搭风"
},
{
"name": "穿着方式",
"value": "开衫"
},
{
"name": "品牌",
"value": "回力"
}
],
"total_sold": "-1",
"skus": {
"sku": [
{
"price": 99,
"total_price": 0,
"orginal_price": 99,
"properties": "47876:47982;47918:47989",
"properties_name": "47876:47982:尺码:M/158-165(建议95-110斤);47918:47989:颜色:黑色",
"quantity": 100,
"sku_id": "100061393512"
},
{
"price": 99,
"total_price": 0,
"orginal_price": 99,
"properties": "47876:48224;47918:47989",
"properties_name": "47876:48224:尺码:L/165-170(建议111-125斤);47918:47989:颜色:黑色",
"quantity": 100,
"sku_id": "100061393540"
},
{
"price": 99,
"total_price": 0,
"orginal_price": 99,
"properties": "47876:48347;47918:47989",
"properties_name": "47876:48347:尺码:XL/170-175(建议126-140斤);47918:47989:颜色:黑色",
"quantity": 100,
"sku_id": "100061393554"
},
{
"price": 99,
"total_price": 0,
"orginal_price": 99,
"properties": "47876:51182;47918:47989",
"properties_name": "47876:51182:尺码:2XL/170-175(建议141-155斤);47918:47989:颜色:黑色",
"quantity": 100,
"sku_id": "100061393556"
},
{
"price": 99,
"total_price": 0,
"orginal_price": 99,
"properties": "47876:51290;47918:47989",
"properties_name": "47876:51290:尺码:3XL/175-180(建议156-165斤);47918:47989:颜色:黑色",
"quantity": 100,
"sku_id": "100061393558"
},
{
"price": 99,
"total_price": 0,
"orginal_price": 99,
"properties": "47876:51415;47918:47989",
"properties_name": "47876:51415:尺码:4XL/178-183(建议166-175斤);47918:47989:颜色:黑色",
"quantity": 100,
"sku_id": "100061393562"
},
{
"price": 99,
异常示例复制
{ "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": "taobao", "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 | 未知错误 | 否 |