接口清单(路径 B)
Base:https://api.fahuomao.com
| 用途 | 方法 | 路径 |
|---|---|---|
| 快递列表 | POST | /api/lipin/list |
| 关联审核 | POST | /api/lipin/wx_sph_accept |
| BT1 绑店 | POST | /api/lipin/wx_sph_bind |
| 已绑店铺 | POST | /api/lipin/wx_sph_shops |
| 拉代发单 | POST | /api/lipin/wx_sph_orders |
| 下单 | POST | /api/lipin/buy |
| 查单 | POST | /api/lipin/status |
| 余额 | POST | /api/user/index |
| 健康检查 | GET | /api/health(无需签名) |
1. list · 快递列表
除签名外,可选 xinfeng_type(分类)等。视频号请关注返回中:
| 字段 | 说明 |
|---|---|
| id / kuaidi_id | 快递 ID,下单用 |
| is_wxspinhao / is_wx | 是否视频号官方通道(必须选 1) |
| wx_supplier_id | 商家需关联的供货商 ID |
| min_money | 保证金相关门槛 |
| name 等 | 快递名称、价格等(以实际返回为准) |
请求示例(curl)
curl -X POST 'https://api.fahuomao.com/api/lipin/list' \ -H 'Content-Type: application/x-www-form-urlencoded' \ -d 'username=demo&sid=1730000000&sign=你的md5签名'
成功返回示意
{
"code": 0,
"msg": "ok",
"data": [
{
"id": 12,
"name": "某快递-视频号官方",
"is_wxspinhao": 1,
"wx_supplier_id": "wxSupplierAppIdxxx",
"min_money": "50.00"
}
]
}
2. wx_sph_accept · 关联审核
| 参数 | 必填 | 说明 |
|---|---|---|
| username/sid/sign | 是 | 签名 |
| merchant_appid | 是 | 商家小店 AppID(wx 开头);兼容字段 shop_appid |
| forward_depth | 否 | 多级转发深度,一般由系统自动处理 |
成功:accepted=true,回显 merchant_appid。
curl -X POST 'https://api.fahuomao.com/api/lipin/wx_sph_accept' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'username=demo&sid=1730000000&sign=你的md5签名&merchant_appid=wx商家小店AppID'
# 成功示意
{ "code": 0, "msg": "关联已通过", "data": {
"merchant_appid": "wx商家小店AppID",
"accepted": true
} }
3. wx_sph_bind · BT1 绑店
| 参数 | 必填 | 说明 |
|---|---|---|
| bind_token | 是 | 商家去使用得到的 BT1;兼容 bind_ticket |
| shop_name | 否 | 店铺名兜底 |
成功返回 shop_id、shop_appid、shop_name。注意:须用商家去使用凭证,不要用供货商凭证。
curl -X POST 'https://api.fahuomao.com/api/lipin/wx_sph_bind' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'username=demo&sid=1730000000&sign=你的md5签名&bind_token=BT1.xxxx.xxxx'
# 成功示意
{ "code": 0, "msg": "绑店成功", "data": {
"shop_id": 1001,
"shop_appid": "wx商家小店AppID",
"shop_name": "某某小店",
"api": "wx_spinhao_official"
} }
4. wx_sph_shops · 已绑店铺
仅需签名。返回列表项:shop_id / shop_appid / shop_name。
curl -X POST 'https://api.fahuomao.com/api/lipin/wx_sph_shops' \ -d 'username=demo&sid=1730000000&sign=你的md5签名'
5. wx_sph_orders · 拉代发单
| 参数 | 必填 | 说明 |
|---|---|---|
| shop_id | 是 | 来自 wx_sph_shops |
| start / end | 否 | 时间范围,默认近约 7 天 |
curl -X POST 'https://api.fahuomao.com/api/lipin/wx_sph_orders' \ -d 'username=demo&sid=1730000000&sign=你的md5签名&shop_id=1001&start=2026-09-01%2000:00:00&end=2026-09-15%2023:59:59'
6. user/index · 余额
查询 API 账户余额与相关信息(字段以实际返回为准)。
curl -X POST 'https://api.fahuomao.com/api/user/index' \ -d 'username=demo&sid=1730000000&sign=你的md5签名'
7. health · 健康检查
curl 'https://api.fahuomao.com/api/health'
# { "code": 0, "msg": "ok", "data": { "service": "fahuomao-open-api", ... } }