闲管家开放平台
  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/user/authorize/create
服务商
PC网页端授权闲鱼店铺地址:
https://open.api.goofish.com/authorize?sp=xianyu&force_auth=true&response_type=code&client_id=28189801&redirect_uri=https://oauth.goofish.pro/index.php?callback=服务商的回调地址
H5移动端授权闲鱼店铺地址:
https://open.api.goofish.com/authorize?sp=xianyu&force_auth=true&response_type=code&view=wap&client_id=28189801&redirect_uri=https://oauth.goofish.pro/index.php?callback=服务商的回调地址

请求参数

Query 参数
appid
integer 
必需
开放平台的AppKey
默认值:
{{appid}}
timestamp
integer 
必需
当前时间戳(单位秒,5分钟内有效)
默认值:
{{timestamp}}
seller_id
integer 
可选
商家ID(仅商务对接传入,自研/第三方ERP对接忽略即可)
默认值:
{{seller_id}}
sign
string 
必需
签名MD5值(参考签名说明)
默认值:
{{sign}}
Body 参数application/json
authorize_code
string 
店铺授权码
必需
授权页面获取
shop_name
string 
店铺名称
可选
不传入默认用闲鱼号昵称作为店铺名称
示例值:
手机小店
示例
{
  "authorize_code": "0_R7wySv67HFzU7o3atN3vC8Xp817",
  "shop_name": ""
}

示例代码

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/user/authorize/create?appid=&timestamp=&seller_id={{seller_id}}&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize_code": "0_R7wySv67HFzU7o3atN3vC8Xp817",
    "shop_name": ""
}'

返回响应

🟢200成功
application/json
Body
code
integer <int32>
必需
默认值:
0
msg
string 
必需
默认值:
OK
data
object 
必需
seller_id
integer <int64>
商家ID
必需
authorize_id
integer <int64>
授权ID
必需
示例值:
2670420985643008
authorize_expires
integer <int32>
授权过期时间
必需
user_identity
string 
闲鱼会员ID
必需
闲鱼号唯一标识
示例值:
H8Kx1jFX3Pxe5xYIBdZQOw==
user_name
string 
闲鱼会员名
必需
示例值:
tb924343042
user_nick
string 
闲鱼号昵称
必需
示例值:
精灵的专属蓝兔子
shop_name
string 
店铺名称
必需
示例值:
定时梵蒂冈天通苑
service_support
string 
已开通的服务项
必需
多个时用英文逗号,拼接
枚举值:
SDR : 七天无理由退货
NFR : 描述不符包邮退
VNR : 描述不符全额退(虚拟类)
FD_10MS : 10分钟极速发货(虚拟类)
FD_24HS : 24小时极速发货
FD_48HS : 48小时极速发货
FD_GPA : 正品保障
示例值:
SDR,NFR
is_deposit_enough
boolean 
是否已缴纳足够的服务保证金
必需
示例值:
true
is_pro
boolean 
是否开通鱼小铺
必需
示例值:
true
item_biz_types
string 
准入业务类型
必需
格式:2,10,19
示例
{
  "code": 0,
  "msg": "OK",
  "data": {
    "seller_id": 11,
    "authorize_id": 2670420985643008,
    "authorize_expires": 27,
    "user_identity": "H8Kx1jFX3Pxe5xYIBdZQOw==",
    "user_name": "tb924343042",
    "user_nick": "精灵的专属蓝兔子",
    "shop_name": "定时梵蒂冈天通苑",
    "service_support": "SDR,NFR",
    "is_deposit_enough": true,
    "is_pro": true,
    "item_biz_types": "culpa sit"
  }
}
🟢200失败
修改于 2024-12-04 09:12:32
上一页
查询商家账号(服务商)
下一页
删除闲鱼店铺(服务商)
Built with