闲管家开放平台
  1. 商品
闲管家开放平台
  • 接入说明
  • 代码示例
  • 用户
    • 授权商家账号(服务商)
      POST
    • 创建商家账号(服务商)-废弃
      POST
    • 删除商家账号(服务商)
      POST
    • 查询商家账号(服务商)
      POST
    • 授权闲鱼店铺(服务商)
      POST
    • 删除闲鱼店铺(服务商)
      POST
    • 查询闲鱼店铺
      POST
    • 查询商家地址
      POST
  • 商品
    • 查询商品类目
      POST
    • 查询商品属性
      POST
    • 查询商品列表
      POST
    • 查询商品详情
      POST
    • 查询商品规格
      POST
    • 创建商品(单个)
      POST
    • 创建商品(批量)
      POST
    • 上架商品
      POST
    • 下架商品
      POST
    • 编辑商品
      POST
    • 编辑库存
      POST
    • 删除商品
      POST
  • 订单
    • 查询订单列表
      POST
    • 查询订单详情
      POST
    • 订单卡密列表
      POST
    • 订单物流发货
      POST
    • 订单取消交易
      POST
  • 推送
    • 商品回调通知
    • 商品推送通知
    • 订单推送通知
  • 资金
    • 查询钱包账户余额(服务商)
    • 订购ERP专业版(服务商)
  • 其他
    • 查询快递公司
  • 严选
    • 获取品牌列表
    • 获取机型列表
    • 获取机型类目
    • 获取报告类目
  1. 商品

查询商品详情

POST
/api/open/product/detail

请求参数

Query 参数
appid
integer 
必需
开放平台的AppKey
默认值:
{{appid}}
timestamp
integer 
必需
当前时间戳(单位秒,5分钟内有效)
默认值:
{{timestamp}}
seller_id
integer 
可选
商家ID(仅商务对接传入,自研/第三方ERP对接忽略即可)
默认值:
{{seller_id}}
sign
string 
必需
签名MD5值(参考签名说明)
默认值:
{{sign}}
Body 参数application/json
product_id
integer <int64>
管家商品ID
必需
示例值:
219530767978565
示例
{
  "product_id": 220656347074629
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/api/open/product/detail?appid=&timestamp=&seller_id={{seller_id}}&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product_id": 220656347074629
}'

返回响应

🟢200成功
application/json
Body
code
integer <int32>
必需
默认值:
0
msg
string 
必需
默认值:
OK
data
object 
必需
product_id
integer <int64>
管家商品ID
必需
示例值:
441160510721413
product_status
enum<integer> <int32>
商品状态
必需
枚举值:-1 : 已删除21 : 待发布22 : 销售中23 : 已售罄31 : 手动下架33 : 售出下架36 : 自动下架
枚举值:
-1212223313336
默认值:
0
示例值:
21
item_biz_type
enum<integer> <int32>
商品类型
必需
枚举值:
2 : 普通商品
0 : 已验货
10 : 验货宝
16 : 品牌授权
19 : 闲鱼严选
24: 闲鱼特卖
26: 品牌捡漏
枚举值:
201016192426
示例值:
2
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
示例值:
2
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
示例值:
1
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
默认值:
0
示例值:
100
publish_status
enum<integer> <int32>
发布状态
必需
枚举值:
-1:不可操作(不可上架/编辑)
1:草稿箱(可编辑/删除)
2:待发布(可上架/编辑/删除)
3:销售中(可下架/编辑)
4:已下架(可上架/编辑/删除)
5:已售罄(可上架/编辑/删除)
9:商品异常(可编辑/删除)
枚举值:
-1123459
示例值:
2
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
示例值:
1
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失败
修改于 2024-08-15 10:03:06
上一页
查询商品列表
下一页
查询商品规格
Built with