闲管家开放平台
  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/edit
注意事项:
1:可以只传入需要更新的字段, 没有传入的字段不会更新
2:多规格商品,如果已经发布到闲鱼则不能清空SKU,至少要保留一组
3:如果商品状态为销售中,则同步更新到闲鱼App
特别提醒:
如果商品为在架状态时,采用异步的方式更新商品信息到闲鱼App上,因此更新结果采用异步回调的方式进行通知。
如果商品不是在架状态,即使传入回调地址,也不会触发回调通知。

请求参数

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
必需
示例值:
441160510721413
item_biz_type
enum<integer> <int32>
商品类型ID
可选
枚举值:
2 : 普通商品
0 : 已验货
10 : 验货宝
16 : 品牌授权
19 : 闲鱼严选
24: 闲鱼特卖
26: 品牌捡漏
枚举值:
201016192426
示例值:
2
sp_biz_type
enum<integer> <int32>
商品分类ID
可选
枚举值:
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
category_id
integer <int32>
商品分类
可选
示例值:
50025386
channel_cat_id
string 
商品类目ID
可选
示例值:
e11455b218c06e7ae10cfa39bf43dc0f
channel_pv
array [object {4}] 
商品属性
可选
property_id
string 
属性ID
必需
示例值:
83b8f62c43df34e6
property_name
string 
属性名称
必需
示例值:
品牌
value_id
string 
属性值ID
必需
示例值:
76f78d92eeb4f5f6eccf7d4fabef47b6
value_name
string 
属性值名称
必需
示例值:
Apple/苹果
price
integer <int64>
商品售价(分)
可选
注意:多规格商品时,必须是SKU其中一个金额
>= 1<= 9999999900
示例值:
199900
original_price
integer <int64>
商品原价(分)
可选
>= 0<= 9999999900
示例值:
199900
express_fee
integer <int64>
运费
可选
stock
integer <int32>
商品库存
可选
注意:多规格商品,必须是SKU库存的合计
>= 1<= 399960
示例值:
1
outer_id
string 
商家编码
可选
注意:一个中文按2个字符算
>= 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_shop
array [object {9}] 
发布店铺
可选
user_name
string 
闲鱼会员名
必需
示例值:
tb924343042
province
integer <int32>
商品发货省份
可选
示例值:
110000
city
integer <int32>
商品发货城市
可选
示例值:
110100
district
integer <int32>
商品发货地区
可选
示例值:
110101
title
string 
商品标题
可选
注意:一个中文按2个字符算
>= 1 字符<= 60 字符
示例值:
iPhone 12 128G 黑色
content
string 
商品描述
可选
注意:一个中文按2个字符算,不支持HTML代码,可使用\n换行
>= 5 字符<= 5000 字符
示例值:
iPhone 12 128G 黑色 8新,非诚勿扰~~
images
array[string]
商品图片URL
可选
注意:第1张作为商品主图,前9张发布到闲鱼App
>= 1 items<= 30 items
white_images
string 
商品白底图URL
可选
注意 :
1:如果传入会在闲鱼商品详情显示,并且无法删除,只能修改
2:当商品类型是特卖类型,即item_biz_type=24时,white_images为必填
示例值:
https://xxx.com/xxx1.jpg
service_support
string 
商品服务
可选
多个时用英文逗号,拼接
枚举值:
SDR : 七天无理由退货
NFR : 描述不符包邮退
VNR : 描述不符全额退(虚拟类)
FD_10MS : 10分钟极速发货(虚拟类)
FD_24HS : 24小时极速发货
FD_48HS : 48小时极速发货
FD_GPA : 正品保障
示例值:
SDR,NFR
sku_items
array[object (SKU信息) {4}] 
商品多规格信息
可选
price
integer <int64>
SKU售价(分)
必需
>= 1<= 9999999900
示例值:
199900
stock
integer <int32>
SKU库存
必需
>= 0<= 9999
示例值:
10
sku_text
string 
SKU规格
必需
格式 : 规格:属性,多个时使用";"拼接。如:颜色:白色;容量:128G
示例值:
颜色:黑色;内存:512G
outer_id
string 
SKU商品编码
可选
注意:一个中文按2个字符算
>= 0 字符<= 64 字符
示例值:
2023072101
book_data
object (图书信息) 
图书信息
可选
isbn
string 
图书ISBN码
必需
示例值:
9787505720176
正则匹配:
/^((?:[0-9]{9}X|[0-9]{10})|(?:(?:97(?:8|9))[0-9]{10}))$/
title
string 
图书标题
必需
示例值:
北京法源寺
author
string 
图书作者
可选
>= 1 字符<= 30 字符
示例值:
李敖
publisher
string 
图书出版社
可选
>= 1 字符<= 30 字符
示例值:
中国友谊出版公司
food_data
object (食品信息) 
食品信息
可选
brand
string 
食品品牌
必需
>= 1 字符<= 30 字符
示例值:
旺旺
spec
string 
食品规格
必需
>= 1 字符<= 30 字符
示例值:
大包
pack
string 
食品包装
必需
>= 1 字符<= 10 字符
示例值:
袋装
expire
object 
食品有效期信息
必需
production
object 
食品生产信息
必需
report_data
object (验货报告信息) 
验货报告信息
可选
beauty_makeup
object (美妆信息) 
美妆信息
可选
curio
object (文玩信息) 
文玩信息
可选
jewelry
object (珠宝信息) 
珠宝信息
可选
game
object (游戏信息) 
游戏信息
可选
used_car
object (OpenProductReportUsedCar) 
二手车信息
可选
valuable
object (奢品信息) 
奢品信息
可选
yx_3c
object (严选3c信息) 
可选
notify_url
string 
回调地址
可选
仅在商品状态为在架中编辑时,才会触发回调通知。
回调参数请查看推送目录下的商品回调通知文档。
flash_sale_type
enum<integer> <int32>
闲鱼特卖类型
可选
枚举值:
-仅闲鱼特卖类型可用-
1 : 临期
2 : 孤品
3 : 断码
4 : 微瑕
5 : 尾货
6 : 官翻
7 : 全新
8 : 福袋
99 : 其他
-仅闲鱼特卖类型可用-
-仅品牌捡漏类型可用-
2601 : 微瑕
2602 : 临期
2603 : 清仓
2604 : 官翻
-仅品牌捡漏类型可用-
枚举值:
12345678992601260226032604
示例值:
1
advent_data
object (闲鱼特卖信息) 
闲鱼特卖信息
可选
闲鱼特卖类型为临期非食品行业时必传
expire
object 
有效期信息
必需
production
object 
生产信息
必需
inspect_data
object (验货宝信息) 
验货宝信息
可选
商品类型为验货宝时必传
trade_rule
enum<string> 
交易规则
必需
枚举值:
yhbOptionalyhbOnly
示例值:
yhbOptional
assume_rule
enum<string> 
验货费规则
必需
枚举值:
buyerseller
示例值:
buyer
brand_data
object (品牌捡漏信息) 
品牌捡漏信息
可选
expire
object 
有效期信息
可选
production
object 
生产信息
可选
supplier
string 
供应商名称
可选
images
array [object {3}] 
资质证明
可选
detail_images
array [object {3}] 
详情图片
可选
sku_images
array [object {4}] 
规格图片
可选
src
string 
图片地址
必需
width
integer <int32>
图片宽度
必需
height
integer <int32>
图片高度
必需
sku_text
string 
规格属性
必需
示例值:
颜色:黑色
示例
{
  "product_id": 443299347640581,
  "item_biz_type": 2,
  "sp_biz_type": 1,
  "category_id": 50025386,
  "channel_cat_id": "e11455b218c06e7ae10cfa39bf43dc0f",
  "channel_pv": [
    {
      "property_id": "b5e5462c028aba7f1921b9e373cead75",
      "property_name": "交易形式",
      "value_id": "8a3445658e0bc44687b43d68bdc44732",
      "value_name": "代下单"
    },
    {
      "property_id": "96ad8793a2fdb81bb108d382c4e6ea42",
      "property_name": "面值",
      "value_id": "38ed5f6522cd7ab6",
      "value_name": "100元"
    }
  ],
  "title": "iPhone 12 128G 黑色",
  "price": 550000,
  "original_price": 700000,
  "express_fee": 10,
  "stock": 10,
  "outer_id": "2021110112345",
  "stuff_status": 100,
  "publish_shop": [
    {
      "images": [
        "https://xxx.com/xxx1.jpg",
        "https://xxx.com/xxx2.jpg"
      ],
      "user_name": "闲鱼会员名",
      "province": 130000,
      "city": 130100,
      "district": 130101,
      "title": "商品标题",
      "content": "商品描述。",
      "white_images": "https://xxx.com/xxx1.jpg",
      "service_support": "SDR"
    }
  ],
  "sku_items": [
    {
      "price": 500000,
      "stock": 10,
      "outer_id": "",
      "sku_text": "颜色:白色;容量:128G"
    },
    {
      "price": 600000,
      "stock": 10,
      "outer_id": "",
      "sku_text": "颜色:白色;容量:256G"
    },
    {
      "price": 500000,
      "stock": 10,
      "outer_id": "",
      "sku_text": "颜色:黑色;容量:128G"
    },
    {
      "price": 600000,
      "stock": 10,
      "outer_id": "",
      "sku_text": "颜色:黑色;容量:256G"
    }
  ],
  "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"
      ]
    },
    "yx_3c": {
      "class_id": 10,
      "subclass_id": 1001,
      "brand_id": 10000,
      "brand_name": "苹果",
      "model_id": 10011,
      "model_name": "iPhone 14 Pro",
      "model_sn": "IMEI/序列号",
      "report_user": "张胜男",
      "report_time": "2024-03-15 18:04:44",
      "report_items": [
        {
          "answer_id": 11103,
          "answer_name": "不开机",
          "answer_type": 2,
          "category_name": "拆修侵液",
          "group_name": "系统情况",
          "question_name": "系统情况"
        }
      ],
      "answer_ids": [
        11103,
        11106
      ]
    }
  }
}

示例代码

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/edit?appid=&timestamp=&seller_id={{seller_id}}&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product_id": 443299347640581,
    "item_biz_type": 2,
    "sp_biz_type": 1,
    "category_id": 50025386,
    "channel_cat_id": "e11455b218c06e7ae10cfa39bf43dc0f",
    "channel_pv": [
        {
            "property_id": "b5e5462c028aba7f1921b9e373cead75",
            "property_name": "交易形式",
            "value_id": "8a3445658e0bc44687b43d68bdc44732",
            "value_name": "代下单"
        },
        {
            "property_id": "96ad8793a2fdb81bb108d382c4e6ea42",
            "property_name": "面值",
            "value_id": "38ed5f6522cd7ab6",
            "value_name": "100元"
        }
    ],
    "title": "iPhone 12 128G 黑色",
    "price": 550000,
    "original_price": 700000,
    "express_fee": 10,
    "stock": 10,
    "outer_id": "2021110112345",
    "stuff_status": 100,
    "publish_shop": [
        {
            "images": [
                "https://xxx.com/xxx1.jpg",
                "https://xxx.com/xxx2.jpg"
            ],
            "user_name": "闲鱼会员名",
            "province": 130000,
            "city": 130100,
            "district": 130101,
            "title": "商品标题",
            "content": "商品描述。",
            "white_images": "https://xxx.com/xxx1.jpg",
            "service_support": "SDR"
        }
    ],
    "sku_items": [
        {
            "price": 500000,
            "stock": 10,
            "outer_id": "",
            "sku_text": "颜色:白色;容量:128G"
        },
        {
            "price": 600000,
            "stock": 10,
            "outer_id": "",
            "sku_text": "颜色:白色;容量:256G"
        },
        {
            "price": 500000,
            "stock": 10,
            "outer_id": "",
            "sku_text": "颜色:黑色;容量:128G"
        },
        {
            "price": 600000,
            "stock": 10,
            "outer_id": "",
            "sku_text": "颜色:黑色;容量:256G"
        }
    ],
    "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"
            ]
        },
        "yx_3c": {
            "class_id": 10,
            "subclass_id": 1001,
            "brand_id": 10000,
            "brand_name": "苹果",
            "model_id": 10011,
            "model_name": "iPhone 14 Pro",
            "model_sn": "IMEI/序列号",
            "report_user": "张胜男",
            "report_time": "2024-03-15 18:04:44",
            "report_items": [
                {
                    "answer_id": 11103,
                    "answer_name": "不开机",
                    "answer_type": 2,
                    "category_name": "拆修侵液",
                    "group_name": "系统情况",
                    "question_name": "系统情况"
                }
            ],
            "answer_ids": [
                11103,
                11106
            ]
        }
    }
}'

返回响应

🟢200成功
application/json
Body
code
integer <int32>
必需
默认值:
0
msg
string 
必需
默认值:
OK
data
object 
必需
product_id
integer <int64>
管家商品ID
必需
示例:219530767978565
product_status
integer 
管家商品状态
必需
示例:10
示例
{
  "code": 0,
  "msg": "OK",
  "data": {
    "product_id": 69,
    "product_status": 80
  }
}
🟢200失败
修改于 2024-10-21 06:13:13
上一页
下架商品
下一页
编辑库存
Built with