在当今电子商务繁荣的时代，对于电商平台来说，提供准确、详尽的商品信息对于满足用户需求、提升购物体验至关重要。京东作为中国领先的电商平台，通过其开放的API接口，为开发者提供了获取商品详情的强大工具。本文将深入探讨京东JD商品详情API的返回值，帮助读者精准掌握商品信息，以优化购物流程和提升用户满意度。
一、京东JD商品详情API概述
京东JD商品详情API是京东开放平台提供的一种服务，它允许开发者通过API接口获取京东平台上的商品详细信息。这些信息包括商品标题、价格、库存、描述、图片、规格参数、评价等，为开发者提供了丰富的数据支持。通过调用该API，开发者可以将商品信息集成到自己的网站、应用或系统中，为用户提供更加便捷、个性化的购物体验。
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年秋季"
},
{二、京东JD商品详情API返回值详解
京东JD商品详情API的返回值是一个JSON格式的对象，包含了商品的各类详细信息。以下是对返回值中常见字段的详细解析：
-
商品基本信息：包括商品ID、商品标题、商品图片链接等。这些信息是展示商品时最直观、最基础的部分，能够帮助用户快速了解商品的基本特征。
-
价格与促销信息：返回值中包含商品的原价、促销价、折扣率等价格信息，以及促销活动的具体时间和规则。这些信息对于用户选择购买商品具有重要影响，能够帮助用户判断商品的性价比和是否值得购买。
-
库存与物流信息：通过API可以获取商品的库存状态、发货时间、配送方式等物流信息。这些信息对于用户了解商品的可用性、预估到货时间等方面具有重要参考价值。
-
商品描述与规格参数：商品描述通常包含商品的详细介绍、使用说明等信息，而规格参数则详细列出了商品的各项技术指标。这些信息对于用户了解商品的功能、性能和使用方法等方面具有重要帮助，能够提高用户的购买决策效率。
-
评价与晒单：API还可以返回商品的评价信息，包括用户评价、晒单图片等。这些信息能够帮助用户了解其他购买者的使用感受和评价，为用户的购买决策提供重要参考。
