京东商品详情API接口请求方式及数据文档说明

前言

京东商品详情API接口是京东开放平台为开发者提供的用于获取商品详细信息的接口服务，支持通过商品ID等参数查询商品的标题、价格、库存、图片、描述等详细信息。以下是接口的请求方式及数据文档说明：

---

一、请求方式

1. 接口地址
   • 京东开放平台提供多种接口地址，具体需根据开发者注册后获取的API文档确认。例如：

     https://api.jd.com/routerjson

   • 不同接口可能对应不同的URL路径，需参考官方文档。
2. 请求方法
   • 支持 GET 或 POST 请求，具体取决于接口定义。
3. 请求参数
   • 必填参数：
     • method：接口方法名，例如 jd.union.open.goods.query。
     • app_key：开发者应用的应用密钥。
     • access_token：通过OAuth2.0授权获取的访问令牌。
     • timestamp：请求时间戳，格式为 YYYY-MM-DD HH:mm:ss。
     • sign：请求签名，用于验证请求合法性。
     • param_json：请求参数的JSON字符串，包含商品ID等信息。
   • 示例：

     	{
     	"skuIds": "商品ID",
     	"fields": "title,price,imgUrl,stock"
     	}

4. 签名规则
   • 签名算法通常为 MD5 或 HMAC-SHA256，需将所有参数按字典序排序后拼接成字符串，再与 app_secret 结合生成签名。
5. 请求示例
   • 使用 curl 命令示例：

     bash

     	curl -X GET "https://api.jd.com/routerjson" \
     	-d "method=jd.union.open.goods.query" \
     	-d "app_key=您的AppKey" \
     	-d "access_token=您的AccessToken" \
     	-d "timestamp=2025-04-16 16:00:00" \
     	-d "sign=生成的签名" \
     	-d "param_json={\"skuIds\":\"123456789\"}"

---

二、数据文档说明

1. 返回数据格式
   • 返回数据通常为 JSON 格式，包含商品详情信息及状态码。
2. 数据结构
   • 示例响应：

     json

     	{
     	"jd_union_open_goods_query_responce": {
     	"code": "0",
     	"queryResult": {
     	"skuId": "123456789",
     	"skuName": "商品名称",
     	"price": "99.90",
     	"imageUrl": "https://example.com/image.jpg",
     	"stock": 100,
     	"shopName": "店铺名称",
     	"comments": 1000,
     	"goodCommentsShare": "98%"
     	}
     	}
     	}

3. 字段说明
   • 商品基本信息：
     • skuId：商品SKU ID。
     • skuName：商品名称。
     • price：商品价格。
     • imageUrl：商品图片URL。
   • 库存信息：
     • stock：商品库存数量。
   • 店铺信息：
     • shopName：店铺名称。
   • 评价信息：
     • comments：商品评价总数。
     • goodCommentsShare：好评率。
4. 状态码说明
   • code 为 0 表示请求成功，其他值表示错误，需参考错误码文档。

---