京东JD商品详情API返回值解析：商品数据快速提取

在数字化时代，电商平台为人们提供了丰富的购物选择。京东作为国内领先的电商平台之一，其开放平台为开发者提供了丰富的API接口，使得开发者能够轻松获取商品详情，为用户提供更加便捷、个性化的购物体验。本文将详细解析京东JD商品详情API的返回值，帮助开发者快速提取商品数据，实现精准推荐和展示。

一、京东JD商品详情API概述

京东JD商品详情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商品详情

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python
• Golang
• javascript
• JS-SDK
• Ruby
• Swift
• Objective-C
• C
• C++
• Node.JS
• Kotlin
• Rust

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

二、API调用流程

要使用京东JD商品详情API，首先需要在京东开放平台注册账号，并创建应用获取API密钥。然后，根据京东开放平台的文档，构造正确的API请求，包括设置请求参数、请求头等信息。最后，发送请求到指定的API接口，并解析返回的响应数据。

三、API返回值详解

京东JD商品详情API的返回值通常是一个包含多个字段的JSON对象或XML文档。下面我们将对这些字段进行详细的解释，并给出相应的代码示例。

1. 商品ID：每个商品在京东平台上都有一个唯一的商品ID，这是商品的唯一标识符。通过商品ID，可以精确地定位到具体的商品，并获取其详细信息。

2. 商品标题：商品标题是用户了解商品的第一印象，通常包含了商品的品牌、型号、主要功能等关键信息。API返回的商品标题字段可以帮助开发者快速提取这些信息，用于展示或搜索。

3. 商品价格：价格是用户购买商品时最关心的因素之一。API返回的价格字段包含了商品的原价、促销价等信息，开发者可以根据这些信息为用户提供价格比较、优惠提醒等功能。

4. 商品图片：商品图片是用户了解商品外观的重要途径。API返回的图片字段通常包含了商品的主图、详情图等URL链接，开发者可以将这些图片嵌入到自己的应用或网站中，为用户提供更加直观的购物体验。

5. 商品描述：商品描述字段包含了商品的详细介绍、功能特点、使用方法等信息。这些信息对于用户了解商品的性能和使用方式非常重要，开发者可以根据需要将这部分内容展示给用户。

6. 规格参数：规格参数是用户选择商品时的重要参考依据。API返回的规格参数字段详细列出了商品的各种规格信息，如尺寸、重量、材质、功率等。开发者可以根据这些参数为用户提供筛选、对比等功能，帮助用户找到最符合自己需求的商品。

7. 用户评价：用户评价是反映商品质量和口碑的重要依据。API返回的用户评价字段包含了评价数量、评分等信息，开发者可以根据这些信息为用户提供评价展示、评分比较等功能，帮助用户做出更明智的购买决策。

返回数据示例

"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": "回力"
	        }
	    ],