闲管家开放平台
  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
  • 推送
    • 商品回调通知
      POST
    • 商品推送通知
      POST
    • 订单推送通知
      POST
  • 资金
    • 查询钱包账户余额(服务商)
    • 订购ERP专业版(服务商)
  • 其他
    • 查询快递公司
  • 严选
    • 获取品牌列表
    • 获取机型列表
    • 获取机型类目
    • 获取报告类目
  1. 推送

订单推送通知

POST
/order/receive(这里仅做示例)
###请商家自行在闲管家的开放平台填写真实的推送地址###
注意事项:
1:订单信息/订单状态/退款状态发生变更时推送
2:仅推送待发货、已发货、已完成、退款处理中、已退款状态的订单
3:请确保该接口稳定,如果推送失败,最多重试三次
4:只有响应报文的result字段返回success,才认为成功
5:接口请求超时时间为3秒(建议接收到推送通知后,异步处理业务逻辑)

请求参数

Query 参数
appid
integer 
必需
开放平台的AppKey
默认值:
{{appid}}
timestamp
integer 
必需
当前时间戳(单位秒,5分钟内有效)
默认值:
{{timestamp}}
sign
string 
必需
签名MD5值(参考签名说明)
默认值:
{{sign}}
Body 参数application/json
seller_id
integer <int64>
商家ID
必需
user_name
string 
闲鱼会员名
必需
示例值:
tb924343042
order_no
string 
闲鱼订单号
必需
示例值:
2226688164543566229
order_type
enum<integer> <int32>
订单类型
必需
枚举值:
123478910
order_status
enum<integer> <int32>
订单状态
必需
枚举值:
11 : 待付款
12 : 待发货
21 : 已发货
22 : 交易成功
23 : 已退款
24 : 交易关闭
枚举值:
111221222324
refund_status
enum<integer> <int32>
退款状态
必需
枚举值:
0 : 未申请退款(表示买家没有申请退款)
1 : 待商家处理(买家已经申请退款,等待卖家同意)
2 : 待买家退货(卖家已经同意退款,等待买家退货)
3 : 待商家收货(买家已经退货,等待卖家确认收货)
4 : 退款关闭(买家取消退款/超时未处理自动关闭)
5 : 退款成功(卖家同意退款/超时未处理自动退款)
6 : 已拒绝退款(卖家拒绝退款)
8 : 待确认退货地址(等待卖家确认退货地址)
枚举值:
01234568
默认值:
0
modify_time
integer 
订单更新时间
必需
示例值:
1636077365
示例
{
  "order_no": "1339920336328048683",
  "order_status": 11,
  "refund_status": 1,
  "modify_time": 1636013302
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/order/receive(这里仅做示例)?appid=&timestamp=&sign=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_no": "1339920336328048683",
    "order_status": 11,
    "refund_status": 1,
    "modify_time": 1636013302
}'

返回响应

🟢200成功
application/json
Body
result
enum<string> 
结果
必需
枚举值:
success
msg
string 
描述
必需
示例值:
接收成功
示例
{
  "result": "success",
  "msg": "接收成功"
}
🟢200异常
修改于 2024-05-31 10:34:59
上一页
商品推送通知
下一页
查询钱包账户余额(服务商)
Built with