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

请求参数

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失败