物流订阅推送
物流查询 SLA 99.95%累计调用 0 次
订阅物流状态变更，自动回调推送。
订阅快递单号状态变更，当物流状态更新时自动推送至指定URL，支持多次推送直至签收。
收费标准
按量计费
¥0.5000/次
每次调用扣费
QPS 限制
50
每秒最大并发
响应时间
10s
超时上限
对接文档
Request Description · 请求说明
请求方式 POST，参数 num 为快递单号，callback_url 为回调地址。
Endpoint · 接口地址
Request Params · 请求参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 | 示例 |
|---|---|---|---|---|---|
| appkey | string | 必填 | - | 用户API密钥 | ak_xxx |
| com | string | 否 | - | 快递公司编码，不填则自动识别 | SF |
| num | string | 必填 | - | 快递单号 | SF12345678 |
| phone | string | 否 | - | 收/寄件人手机号后四位(顺丰必填) | 8888 |
Request Example · 请求示例
curl -X POST https://api.cli.cc/v1/express/subscribe -H "Content-Type: application/json" -d '{"appkey":"ak_xxx","num":"SF12345678","callback_url":"https://your.com/callback"}'Response Fields · 响应字段说明
{"code":"业务码","msg":"提示","data":{"subscribe_id":"订阅ID","status":"已订阅"}}
Response Example · 响应示例
{"code":0,"msg":"ok","data":{"subscribe_id":"sub_abc123","status":"已订阅"}}Error Codes · 错误码说明
| 错误码 | 说明 |
|---|---|
| 0 | 成功 |
| 10002 | appkey无效 |
| 20001 | 参数错误 |