数字化供应链 接口文档
  1. 商品
数字化供应链 接口文档
  • 公共消息
  • 消息说明
  • 商品
    • 获取商品详情v2
      GET
    • 批量获取详情v2
      POST
    • 获取全量分类v2
      GET
    • 获取逐级类目v2
      GET
    • 批量更新商品v2
      POST
  • 选品
    • 选品分组列表v2
      GET
    • 在线选品v2(新版)
      POST
    • 选品分组商品列表v2
      POST
    • 选品库增加商品v2
      GET
    • 选品库商品列表v2
      GET
    • 选品库移除商品v2
      GET
  • 订单
    • 可售检测V2
      GET
    • 前置校验V2
      POST
    • 提交下单V2
      POST
    • 全平台订单列表V2
      GET
    • 各平台订单列表V2
      GET
  • 物流
    • 确认收货
      POST
    • 物流查询v2
      GET
    • 获取物流公司列表V2
      GET
  • 售后
    • 售后前置校验V2
      POST
    • 上传售后凭证(图片)V2
      POST
    • 申请售后V2
      POST
    • 售后列表V2
      GET
    • 售后详情V2
      GET
    • 退货商家邮寄信息
      PATCH
  • 消息
    • 店铺订单取消
    • 商品下架
    • 交易成功
    • 售后同意
    • 商品上架
    • 商品已收货
    • 售后拒绝
    • 商品修改
    • 商家已发货
    • 售后退款到账
    • 商品价格变更
    • 商品库添加
    • 移除商品库商品
  1. 商品

获取商品详情v2

GET
/v2/Goods/Detail

京东图片尺寸、水印规则:#

其中 n0(最大图 800800px)、n1(350350px)、n2(160160px)、n3(130130px)、n4(100*100px) 为图片大小。 其中n0带有京东水印,其余的不带,可以根据业务去获取不同大小图片(默认返回为n0,如需不带水印的其他尺寸可获取后正则替换n0即可)

京东多规格图片描述展示问题:#

由于京东给我们的商品都是单规格,我们聚合成了多规格。 如果想要不同规格的图片、描述做切换展示,可以通过商品详情接口里的specs->option->old_goods_id作为商品主键去搜索商品详情接口,返回的图片、描述就是对应sku的图片、描述

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/v2/Goods/Detail?id=1209' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Body

示例
{
    "msg": "string",
    "code": 0,
    "data": {
        "id": 0,
        "third_id": 0,
        "shop_id": 0,
        "cloud_shop_id": 0,
        "source": 0,
        "category_id": "string",
        "dis_category_end_id": "string",
        "third_category_name": "string",
        "third_brand_name": "string",
        "unit": "string",
        "origin": "string",
        "title": "string",
        "market_price": 0,
        "guide_price": 0,
        "agreement_price": 0,
        "activity_price": 0,
        "sale_price": 0,
        "cost_price": 0,
        "activity_rate": 0,
        "cover": "string",
        "stock": 0,
        "total_stock": 0,
        "status": 0,
        "sale": 0,
        "created_time": 0,
        "updated_time": 0,
        "is_free_shipping": 0,
        "description": "string",
        "covers": [
            "string"
        ],
        "attributes": [
            {
                "name": "string",
                "value": "string"
            }
        ],
        "specs": {
            "names": [
                {
                    "id": 0,
                    "goods_id": 0,
                    "name": "string",
                    "sort": 0
                }
            ],
            "values": [
                {
                    "id": 0,
                    "goods_id": 0,
                    "spec_name_id": 0,
                    "name": "string",
                    "sort": 0
                }
            ],
            "options": [
                {
                    "id": 0,
                    "goods_id": 0,
                    "spec_value_ids": "string",
                    "spec_value_names": "string",
                    "market_price": 0,
                    "activity_price": 0,
                    "guide_price": 0,
                    "agreement_price": 0,
                    "sale_price": 0,
                    "cost_price": 0,
                    "stock": 0,
                    "weight": 0,
                    "image": "string",
                    "status": 0,
                    "old_goods_id": 0
                }
            ]
        },
        "old_goods_title": "string",
        "shop_name": "string",
        "goods_type": 0,
        "tax": {
            "id": "string",
            "number": "string",
            "name": "string",
            "explain": "string",
            "key_word": "string",
            "kingdee_code": "string",
            "kingdee_tax": "string",
            "kingdee_is_gather": 0
        },
        "is_choose": 0,
        "is_tax": 0
    }
}
修改于 2025-05-20 02:44:15
上一页
消息说明
下一页
批量获取详情v2
Built with