使用指南

注册与认证：

在京东开放平台注册成为开发者，并创建应用。

应用创建成功后，获取 App Key 和 App Secret，它们是后续调用 API 时用于身份验证的关键。

了解接口信息：

查找京东开放平台提供的关键字搜索接口文档，可在开发者中心或相关文档页面获取。

明确接口的请求地址、支持的请求方式（如 GET、POST）、必填参数和可选参数等。

构建请求：

根据需求确定要搜索的关键字以及其他必要的请求参数，如页码、每页商品数量、价格范围、排序方式等。

将请求参数按照特定的格式（如 URL 编码）进行编码，并附加到 API 的 URL 中。如果使用 POST 方式，还需将参数以规定的格式放在请求体中。

发送请求并获取数据：

使用编程语言提供的 HTTP 请求库，向京东 API 接口发送请求。确保在请求头中包含正确的身份验证信息和必要的参数。

接收 API 接口返回的响应，通常是一个包含商品详细信息的 JSON 格式数据。

解析返回数据：使用编程语言中的 JSON 解析库，解析返回的 JSON 数据，提取出所需的商品信息，如商品名称、价格、图片、评价数量、销售数量等。

请求示例：

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

响应示例：

{
"item": {
  "num_iid": "100126351037",
  "title": "京东鲜花爱丽丝泡泡鲜切花云南鲜花家庭插花爱丽丝泡泡10枝源头直发",
  "desc_short": "",
  "price": "30.90",
  "total_price": "",
  "suggestive_price": "",
  "orginal_price": "49.00",
  "nick": "京东鲜花自营专区",
  "num": "99",
  "detail_url": "https://item.jd.com/100126351037.html",
  "pic_url": "http://m.360buyimg.com/mobilecms/s1080x1080_jfs/t1/237316/6/21934/216236/672351e2F577e6517/05e435e41704c438.jpg!q70.jpg.webp",
  "sku_pic": "http://m.360buyimg.com/mobilecms/s1080x1080_jfs/t1/237316/6/21934/216236/672351e2F577e6517/05e435e41704c438.jpg!q70.jpg.webp",
  "brand": "京东鲜花",
  "brandId": "777210",
  "rootCatId": "",
  "cid": "12473",
  "desc": "",
  "item_imgs": [
{
  "url": "http://m.360buyimg.com/mobilecms/s1080x1080_jfs/t1/237316/6/21934/216236/672351e2F577e6517/05e435e41704c438.jpg!q70.jpg.webp"
},
{
  "url": "http://m.360buyimg.com/mobilecms/s1080x1080_jfs/t1/130400/14/49841/200051/672351e1F7586d48e/017bd81ed5b931e0.jpg!q70.jpg.webp"
},
{
  "url": "http://m.360buyimg.com/mobilecms/s1080x1080_jfs/t1/163105/34/50182/163954/672351deFf0c2659c/8656066ad673967b.jpg!q70.jpg.webp"
},
{
  "url": "http://m.360buyimg.com/mobilecms/s1080x1080_jfs/t1/213329/6/45782/224845/672351deFc2298b4c/3b19b7f988852b73.jpg!q70.jpg.webp"
}
  ],
  "item_weight": "",
  "post_fee": "",
  "freight": "",
  "express_fee": "",
  "ems_fee": "",
  "shipping_to": "",
  "video": {
"url": null
  },
  "sample_id": "",
  "props_name": "1:1:规格:【买20枝送10枝】随机色玫瑰20枝送10枝尤加利;1:2:规格:玫瑰混搭小花束;1:3:规格:玫瑰百合混搭小花束;1:4:规格:玫瑰向日葵混搭小花束;1:5:规格:多头泡泡单色随机10枝;1:6:规格:多头泡泡混搭随机10枝;1:7:规格:多头橙芭比泡泡10枝;1:8:规格:多头折射泡泡10枝;1:9:规格:多头黄泡泡10枝;1:10:规格:多头红泡泡10枝;1:11:规格:多头爱丽丝泡泡10枝;1:12:规格:多头果汁阳台泡泡10枝;1:13:规格:多头巧克力泡泡10枝",
  "prop_imgs": {
"prop_img": []
  },
  "props_imgs": {
"prop_img": [
  {
"properties": "1:1",
"url": ""
  },
  {
"properties": "1:2",
"url": ""
  },
  {
"properties": "1:3",
"url": ""
  },
  {
"properties": "1:4",
"url": ""
  },
  {
"properties": "1:5",
"url": ""
  },
  {
"properties": "1:6",
"url": ""
  },
  {
"properties": "1:7",
"url": ""
  },
  {
"properties": "1:8",
"url": ""
  },
  {
"properties": "1:9",
"url": ""
  },
  {
"properties": "1:10",
"url": ""
  },
  {
"properties": "1:11",
"url": ""
  },
  {
"properties": "1:12",
"url": ""
  },
  {
"properties": "1:13",
"url": ""
  }
]
  },
  "property_alias": "1:1:【买20枝送10枝】随机色玫瑰20枝送10枝尤加利;1:2:玫瑰混搭小花束;1:3:玫瑰百合混搭小花束;1:4:玫瑰向日葵混搭小花束;1:5:多头泡泡单色随机10枝;1:6:多头泡泡混搭随机10枝;1:7:多头橙芭比泡泡10枝;1:8:多头折射泡泡10枝;1:9:多头黄泡泡10枝;1:10:多头红泡泡10枝;1:11:多头爱丽丝泡泡10枝;1:12:多头果汁阳台泡泡10枝;1:13:多头巧克力泡泡10枝",
  "props": [
{
  "name": "品牌：",
  "value": "京东鲜花"
},
{
  "name": "商品名称：",
  "value": "京东鲜花爱丽丝泡泡10枝"
},
{
  "name": "花头数量：",
  "value": "多头"
},
{
  "name": "国产/进口：",
  "value": "国产"
},
{
  "name": "是否醒花：",
  "value": "需要醒花"
},
{
  "name": "开放程度：",
  "value": "微露花芯（2度）"
}
  ],
  "total_sold": "",
  "skus": [
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:1:【买20枝送10枝】随机色玫瑰20枝送10枝尤加利",
  "properties_name": "1:1:规格:【买20枝送10枝】随机色玫瑰20枝送10枝尤加利",
  "quantity": "99",
  "sku_id": "100116243996",
  "sku_url": "https://item.jd.com/100116243996.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:2:玫瑰混搭小花束",
  "properties_name": "1:2:规格:玫瑰混搭小花束",
  "quantity": "99",
  "sku_id": "100127411315",
  "sku_url": "https://item.jd.com/100127411315.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:3:玫瑰百合混搭小花束",
  "properties_name": "1:3:规格:玫瑰百合混搭小花束",
  "quantity": "99",
  "sku_id": "100127411317",
  "sku_url": "https://item.jd.com/100127411317.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:4:玫瑰向日葵混搭小花束",
  "properties_name": "1:4:规格:玫瑰向日葵混搭小花束",
  "quantity": "99",
  "sku_id": "100155425904",
  "sku_url": "https://item.jd.com/100155425904.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:5:多头泡泡单色随机10枝",
  "properties_name": "1:5:规格:多头泡泡单色随机10枝",
  "quantity": "99",
  "sku_id": "100127411345",
  "sku_url": "https://item.jd.com/100127411345.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:6:多头泡泡混搭随机10枝",
  "properties_name": "1:6:规格:多头泡泡混搭随机10枝",
  "quantity": "99",
  "sku_id": "100155425892",
  "sku_url": "https://item.jd.com/100155425892.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:7:多头橙芭比泡泡10枝",
  "properties_name": "1:7:规格:多头橙芭比泡泡10枝",
  "quantity": "99",
  "sku_id": "100153834042",
  "sku_url": "https://item.jd.com/100153834042.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:8:多头折射泡泡10枝",
  "properties_name": "1:8:规格:多头折射泡泡10枝",
  "quantity": "99",
  "sku_id": "100153834026",
  "sku_url": "https://item.jd.com/100153834026.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:9:多头黄泡泡10枝",
  "properties_name": "1:9:规格:多头黄泡泡10枝",
  "quantity": "99",
  "sku_id": "100153834018",
  "sku_url": "https://item.jd.com/100153834018.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:10:多头红泡泡10枝",
  "properties_name": "1:10:规格:多头红泡泡10枝",
  "quantity": "99",
  "sku_id": "100126351047",
  "sku_url": "https://item.jd.com/100126351047.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:11:多头爱丽丝泡泡10枝",
  "properties_name": "1:11:规格:多头爱丽丝泡泡10枝",
  "quantity": "99",
  "sku_id": "100126351037",
  "sku_url": "https://item.jd.com/100126351037.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:12:多头果汁阳台泡泡10枝",
  "properties_name": "1:12:规格:多头果汁阳台泡泡10枝",
  "quantity": "99",
  "sku_id": "100126351035",
  "sku_url": "https://item.jd.com/100126351035.html"
},
{
  "price": "30.90",
  "orginal_price": "49.00",
  "properties": "1:13:多头巧克力泡泡10枝",
  "properties_name": "1:13:规格:多头巧克力泡泡10枝",
  "quantity": "99",
  "sku_id": "100126351039",
  "sku_url": "https://item.jd.com/100126351039.html"
}
  ],
  "seller_id": "",
  "sales": "",
  "shop_id": 1000344190,
  "_ddf": "fb",
  "props_list": {
"1:1": "规格:【买20枝送10枝】随机色玫瑰20枝送10枝尤加利",
"1:2": "规格:玫瑰混搭小花束",
"1:3": "规格:玫瑰百合混搭小花束",
"1:4": "规格:玫瑰向日葵混搭小花束",
"1:5": "规格:多头泡泡单色随机10枝",
"1:6": "规格:多头泡泡混搭随机10枝",
"1:7": "规格:多头橙芭比泡泡10枝",
"1:8": "规格:多头折射泡泡10枝",
"1:9": "规格:多头黄泡泡10枝",
"1:10": "规格:多头红泡泡10枝",
"1:11": "规格:多头爱丽丝泡泡10枝",
"1:12": "规格:多头果汁阳台泡泡10枝",
"1:13": "规格:多头巧克力泡泡10枝"
  },
  "seller_info": {
"nick": "京东鲜花自营专区",
"city": "",
"level": "",
"rate": "",
"score": 0,
"delivery_score": "",
"item_score": "",
"shop_type": "",
"user_num_id": "",
"sid": 1000344190,
"title": "",
"zhuy": "https://mall.jd.com/index-1000344190.html",
"shop_name": ""
  },
  "props_img": [],
  "shop_item": [],
  "relate_items": []
},
"secache": "e4be299217ffd4296ed5d43e9f8a0554",
"secache_time": 1733451980,
"secache_date": "2024-12-06 10:26:20",
"translate_status": "",
"translate_time": 0,
"language": {
  "default_lang": "cn",
  "current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:11 max:5000 all[23=11+5+7];expires:2025-12-18",
"execution_time": "7.124",
"server_time": "Beijing/2024-12-06 10:26:20",
"client_ip": "106.6.37.210",
"call_args": [
  "100126351037"
],
"api_type": "jd",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "3.31MB",
"request_id": "3.675260c5399d0",
"last_id": "3798001718"
  }