京东JD商品详情API返回值分析:提升商品信息获取效率

京东JD商品详情API是一个重要的工具,它允许开发者从京东平台上获取商品的详细信息。以下是关于京东JD商品详情API返回值的分析,旨在帮助提升商品信息获取效率:

  1. 返回值结构

    • 当你成功调用京东JD商品详情API后,会收到一个包含商品详细信息的JSON格式的返回值。JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,易于人阅读和编写,同时也易于机器解析和生成。
    • 在这个JSON返回值中,每个字段都由一个键(key)和一个值(value)组成,键和值之间用冒号分隔,不同的字段之间用逗号分隔。
  2. 主要返回值字段

    • 商品标题:商品的名称或标题,用于展示给用户,帮助用户了解商品的基本信息。
    • 商品价格:商品的销售价格,包括原价、促销价等,对用户的购物决策具有重要意义。
    • 商品图片:商品的图片链接或URL,开发者可以通过这些链接获取商品的图片,用于展示给用户或进行其他操作。
    • 商品规格:商品的详细规格信息,如尺寸、颜色、材质等,有助于用户了解商品的具体参数。
    • 商品参数:商品的附加参数信息,如品牌、产地、保修期等,进一步丰富用户对商品的了解。
    • 店铺信息:商品所属店铺的相关信息,如店铺名称、店铺评分等,有助于用户了解商家的信誉和服务质量。
  3. 如何提升商品信息获取效率

    • 了解API文档:首先,深入阅读并理解京东官方提供的JD商品详情API文档,确保你清楚每个参数的作用和返回值的含义。
    • 优化请求参数:根据实际需求,优化请求参数,如只获取你关心的字段信息,避免返回冗余数据。
    • 使用合适的编程语言和库:选择你熟悉的编程语言和库来处理JSON数据,可以大大提高数据处理的效率。
    • 缓存策略:对于频繁访问且数据变动不大的商品信息,可以考虑使用缓存策略,减少不必要的API调用。
    • 错误处理和重试机制:实现完善的错误处理和重试机制,确保在网络波动或API故障时,能够自动重试或给出明确的错误提示。
    • 并行处理:如果需要获取多个商品的信息,可以考虑使用并行处理的方式,同时发起多个API请求,以加快数据处理速度。

 

jd.item_get

公共参数

请求地址: https://api-gw.onebound.cn/jd/item_get

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数: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)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值