数字化供应链 接口文档
  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 参数
id
string 
必需
商品spu id(商品列表中的id字段)
示例值:
1209
Header 参数
Content-Type
string 
必需
示例值:
application/json

示例代码

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
number 
必需
data
object 
必需
id
number 
必需
third_id
number 
必需
第三方商品id(可忽视)
shop_id
number 
店铺id
必需
cloud_shop_id
number 
必需
云仓店铺ID 0代表没有
source
number 
必需
平台来源1生态云仓11自营云仓2鲸选6阿里16跨境一仓12特卖一仓14华东一仓18厂家直销19云仓优选20天猫优选21苏宁
category_id
string 
京东等平台分类id
必需
dis_category_end_id
string 
必需
dis_category 表关联ID
third_category_name
string 
分类名称
必需
third_brand_name
string 
分类品牌名称
必需
unit
string 
单位(默认"个")
必需
origin
string 
产地
必需
title
string 
名称
必需
market_price
number 
市场价(单位:分)
必需
guide_price
number 
指导价(单位:分)
必需
agreement_price
number 
协议价(单位:分)
必需
activity_price
number 
营销价(单位:分)
必需
sale_price
number 
销售价(单位:分)
必需
cost_price
number 
成本价(单位:分)
必需
activity_rate
number 
营销利润率
必需
cover
string 
主图
必需
stock
number 
库存
必需
total_stock
number 
总库存
必需
status
number 
0下架1上架
必需
sale
number 
销量
必需
created_time
number 
创建时间
必需
updated_time
number 
更新时间
必需
is_free_shipping
number 
0不包邮1包邮
必需
description
string 
描述
必需
covers
array[string]
轮播图
必需
attributes
array [object {2}] 
属性
必需
specs
object 
规格
必需
old_goods_title
string 
必需
规格中的old_goods_id对应的商品标题
shop_name
string 
商家名称
必需
goods_type
number 
必需
当平台来源为京东时默认包含京东自营和厂直,1代表京东自营0厂直(其他平台来源默认为1)
tax
object 
必需
is_choose
integer 
必需
是否已加入选品【1是 2否】
is_tax
integer 
可选
是否含税【0否1是】
示例
{
    "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
    }
}
上一页
消息说明
下一页
批量获取详情v2
Built with