查询商品详情 - 闲管家开放平台

请求参数

Query 参数

appid

integer

必需

开放平台的AppKey

默认值:

timestamp

integer

必需

当前时间戳（单位秒，5分钟内有效）

默认值:

seller_id

integer

可选

商家ID（仅商务对接传入，自研/第三方ERP对接忽略即可）

默认值:

sign

string

必需

签名MD5值（参考签名说明）

默认值:

Body 参数application/json

product_id

integer <int64>

管家商品ID

必需

示例值:

219530767978565

示例

{
  "product_id": 220656347074629
}

返回响应

🟢200成功

application/json

Body

code

integer <int32>

必需

默认值:

msg

string

必需

默认值:

data

object

必需

product_id

integer <int64>

管家商品ID

必需

示例值:

441160510721413

product_status

enum<integer> <int32>

商品状态

必需

枚举值：-1 : 已删除21 : 待发布22 : 销售中23 : 已售罄31 : 手动下架33 : 售出下架36 : 自动下架

枚举值:

-1212223313336

默认值:

示例值:

item_biz_type

enum<integer> <int32>

商品类型

必需

枚举值：
2 : 普通商品
0 : 已验货
10 : 验货宝
16 : 品牌授权
19 : 闲鱼严选
24: 闲鱼特卖
26: 品牌捡漏

枚举值:

201016192426

示例值:

sp_biz_type

enum<integer> <int32>

商品行业

必需

枚举值：
1 : 手机
2 : 潮品
3 : 家电
8 : 乐器
9 : 3C数码
16 : 奢品
17 : 母婴
18 : 美妆个护
19 : 文玩/珠宝
20 : 游戏电玩
21 : 家居
22 : 虚拟游戏
23 : 租号
24 : 图书
25 : 卡券
27 : 食品
28 : 潮玩
29 : 二手车
30 : 宠植
31 : 工艺礼品
33 : 汽车服务
99 : 其他

枚举值:

123891617181920212223242527282930313399

示例值:

channel_cat_id

string

商品类目ID

必需

示例值:

e11455b218c06e7ae10cfa39bf43dc0f

channel_pv

array [object {4}]

商品属性

可选

title

string

商品标题

必需

>= 1 字符<= 60 字符

示例值:

iPhone 12 128G 黑色

price

integer <int64>

商品售价（分）

必需

>= 1<= 9999999900

示例值:

199900

original_price

integer <int64>

商品原价（分）

可选

>= 0<= 9999999900

示例值:

199900

express_fee

integer <int64>

运费（分）

可选

stock

integer <int32>

商品库存

必需

>= 1<= 399960

示例值:

sold

integer <int32>

商品销量

必需

outer_id

string

商家编码

可选

>= 1 字符<= 64 字符

示例值:

317837811

stuff_status

enum<integer> <int32>

商品成色

可选

枚举值：
0 : 无成色（普通商品可用）
100 : 全新
-1 : 准新
99 : 99新
95 : 95新
90 : 9新
80 : 8新
70 : 7新
60 : 6新
50 : 5新

-仅品牌捡漏类型可用-
40 : 未使用·中度瑕疵
30 : 未使用·轻微瑕疵
20 : 未使用·仅拆封
10 : 未使用·准新
100 : 全新未使用
-仅品牌捡漏类型可用-

及以下注意：非普通商品类型时必填~~

枚举值:

100-199959080706050403020100

默认值:

示例值:

100

publish_status

enum<integer> <int32>

发布状态

必需

枚举值：
-1：不可操作（不可上架/编辑）
1：草稿箱（可编辑/删除）
2：待发布（可上架/编辑/删除）
3：销售中（可下架/编辑）
4：已下架（可上架/编辑/删除）
5：已售罄（可上架/编辑/删除）
9：商品异常（可编辑/删除）

枚举值:

-1123459

示例值:

publish_shop

array [object {11}]

发布店铺

可选

sku_items

array[object (SKU信息) {6}]

商品多规格信息

可选

book_data

object (图书信息)

图书信息

可选

food_data

object (食品信息)

食品信息

可选

report_data

object (验货报告信息)

验货报告信息

可选

specify_publish_time

string

定时上架时间

可选

示例值:

2023-07-21 00:00:00

online_time

integer

商品上架时间

可选

示例值:

1636019388

offline_time

integer

商品下架时间

可选

示例值:

1636019388

sold_time

integer

商品售罄时间

可选

示例值:

1636019388

create_time

integer

商品创建时间

可选

示例值:

1636019388

update_time

integer

商品更新时间

可选

示例值:

1636019388

flash_sale_type

enum<integer> <int32>

闲鱼特卖类型

可选

枚举值：
-仅闲鱼特卖类型可用-
1 : 临期
2 : 孤品
3 : 断码
4 : 微瑕
5 : 尾货
6 : 官翻
7 : 全新
8 : 福袋
99 : 其他
-仅闲鱼特卖类型可用-

-仅品牌捡漏类型可用-
2601 : 微瑕
2602 : 临期
2603 : 清仓
2604 : 官翻
-仅品牌捡漏类型可用-

枚举值:

12345678992601260226032604

示例值:

advent_data

object (闲鱼特卖信息)

闲鱼特卖信息

可选

brand_data

object (品牌捡漏信息)

品牌捡漏信息

可选

detail_images

array [object {3}]

详情图片

可选

sku_images

array [object {4}]

规格图片

可选

示例

成功示例异常示例

{
  "code": 0,
  "msg": "OK",
  "data": {
    "product_id": 441864286003077,
    "product_status": 21,
    "item_biz_type": 2,
    "sp_biz_type": 25,
    "channel_cat_id": "fee623cbc89d0ab7a7f7e02f36b0b49a",
    "channel_pv": [
      {
        "property_id": "b5e5462c028aba7f1921b9e373cead75",
        "property_name": "交易形式",
        "value_id": "8a3445658e0bc44687b43d68bdc44732",
        "value_name": "代下单"
      },
      {
        "property_id": "96ad8793a2fdb81bb108d382c4e6ea42",
        "property_name": "面值",
        "value_id": "38ed5f6522cd7ab6",
        "value_name": "100元"
      }
    ],
    "title": "商品标题",
    "price": 10000,
    "original_price": 12000,
    "express_fee": 0,
    "stock": 1,
    "outer_id": "YCHQCS1111",
    "stuff_status": 0,
    "publish_status": 2,
    "publish_shop": [
      {
        "user_name": "",
        "province": 130000,
        "city": 130100,
        "district": 130101,
        "title": "商品标题",
        "content": "商品描述。",
        "images": [
          "product/20230722/161018-6546kdnp.jpg"
        ],
        "white_images": "",
        "service_support": ""
      }
    ],
    "book_data": {
      "title": "北京法源寺",
      "author": "李敖",
      "publisher": "中国友谊出版公司",
      "isbn": "9787505720176"
    },
    "food_data": {
      "pack": "罐装",
      "spec": "150",
      "brand": "伏特加伏特加",
      "expire": {
        "num": 360,
        "unit": "天"
      },
      "production": {
        "date": "2021-11-29",
        "address": {
          "detail": "北京市东城区x街道",
          "province": 130000,
          "city": 130100,
          "district": 130101
        }
      }
    },
    "report_data": {
      "used_car": {
        "report_url": "https://xxxxxx.com"
      },
      "beauty_makeup": {
        "org_id": 181,
        "brand": "欧莱雅",
        "spec": "小瓶装",
        "level": "全新",
        "org_name": "哈哈哈",
        "qc_result": "通过",
        "images": [
          "https://xxx.com/xxx1.jpg",
          "https://xxx.com/xxx2.jpg"
        ]
      },
      "game": {
        "qc_no": "123123",
        "qc_result": "符合",
        "title": "测试游戏",
        "platform": "小霸王",
        "images": [
          "https://xxx.com/xxx1.jpg",
          "https://xxx.com/xxx2.jpg"
        ]
      },
      "curio": {
        "org_id": 191,
        "org_name": "NGC评级",
        "size": "12mmx14mm",
        "material": "陶瓷",
        "qc_no": "3131319",
        "qc_result": "真品",
        "images": [
          "https://xxx.com/xxx1.jpg",
          "https://xxx.com/xxx2.jpg"
        ]
      },
      "jewelry": {
        "org_name": "某某平台",
        "shape": "圆形",
        "color": "白色",
        "weight": "125g",
        "qc_no": "3131319",
        "qc_desc": "无瑕疵",
        "images": [
          "https://xxx.com/xxx1.jpg",
          "https://xxx.com/xxx2.jpg"
        ]
      },
      "valuable": {
        "org_id": 162,
        "org_name": "国检",
        "qc_no": "454545",
        "qc_result": "符合",
        "images": [
          "https://xxx.com/xxx1.jpg",
          "https://xxx.com/xxx2.jpg"
        ]
      }
    },
    "spec_type": 1,
    "specify_publish_time": "",
    "online_time": 1690013426,
    "offline_time": 1690013665,
    "sold_time": 1690013665,
    "update_time": 1690013710,
    "create_time": 1690013424
  }
}

🟢200失败