创建商品(单个)
POST
https://open.goofish.pro/api/open/product/create
/api/open/product/create
item_biz_type、sp_biz_type、channel_cat_id 存在依赖关系,务必传入正确
请求参数
Query 参数
appid
integer
必需
默认值:
{{appid}}
timestamp
integer
必需
默认值:
{{timestamp}}
seller_id
integer
可选
默认值:
{{seller_id}}
sign
string
必需
默认值:
{{sign}}
Body 参数application/json
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}]
商品属性
查询商品属性
接口获取属性参数property_id
string
属性ID
示例值:
83b8f62c43df34e6
property_name
string
属性名称
示例值:
品牌
value_id
string
属性值ID
示例值:
76f78d92eeb4f5f6eccf7d4fabef47b6
value_name
string
属性值名称
示例值:
Apple/苹果
price
integer <int64>
商品售价(分)
>= 1<= 9999999900
示例值:
199900
original_price
integer <int64>
商品原价(分)
item_biz_type
=24时,original_price
为必填>= 0<= 9999999900
示例值:
199900
express_fee
integer <int64>
运费(分)
stock
integer <int32>
商品库存
>= 1<= 399960
示例值:
1
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_shop
array [object {9}]
发布店铺
user_name
string
闲鱼会员名
示例值:
tb924343042
province
integer <int32>
商品发货省份
示例值:
110000
city
integer <int32>
商品发货城市
示例值:
110100
district
integer <int32>
商品发货地区
示例值:
110101
title
string
商品标题
>= 1 字符<= 60 字符
示例值:
iPhone 12 128G 黑色
content
string
商品描述
>= 5 字符<= 10000 字符
示例值:
iPhone 12 128G 黑色 8新,非诚勿扰~~
images
array[string]
商品图片URL
>= 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规格
示例值:
颜色:黑色;内存:512G
outer_id
string
SKU商品编码
>= 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信息)
可选
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
规格属性
示例值:
颜色:黑色
示例
{
"item_biz_type": 2,
"sp_biz_type": 1,
"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元"
}
],
"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": "商品描述。",
"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": "哈哈哈",
"images": [
"https://xxx.com/xxx1.jpg",
"https://xxx.com/xxx2.jpg"
]
},
"game": {
"qc_no": "123123",
"qc_desc": "符合",
"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",
"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_desc": "经检测符合制造商公示的制作工艺",
"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
管家商品状态
示例值:
21
示例
{
"code": 0,
"msg": "OK",
"data": {
"product_id": 219530767978565,
"product_status": 21
}
}
🟢200失败
修改于 2024-10-26 10:45:21