抖音来客 · 纯协议 API 文档

每个商户对应一个手机号账号 + 一个商户名。流程：

1. 注册账号：POST /api/account/register，传商户名（groupid/poi_id 留空）
2. 登录：POST /api/protocol/login，传手机号 + 验证码 + account=商户名
   会话自动写入 sessions/商户名.json，登录成功自动抓取 groupid/poi_id 回写配置
3. 验券/核销：account 传商户名，自动用该商户的会话 + 门店

每个商户独立会话、独立门店上下文，互不影响。多商户并发无冲突。

① 发送验证码

curl -X POST https://hx.gxv.red/api/protocol/login \
  -H "Content-Type: application/json" \
  -d '{"phone":"17696265267"}'

响应：{"ok":false,"need_code":true,"message":"验证码已发送"}

② 登录（成功后自动抓 groupid/poi_id）

curl -X POST https://hx.gxv.red/api/protocol/login \
  -H "Content-Type: application/json" \
  -d '{"phone":"17696265267","code":"1234","account":"像素创意手作DIY"}'

响应：{"ok":true,"context":{"groupid":"...","poi_id":"...","ok":true,"match_warning":"",...},...}

⚠ 若 match_warning 非空（如"未找到商户 [xx], 可选商户: A/B/C"或"当前登录账号未绑定任何商户"），说明登录手机号下没有该商户，需用绑定该商户的手机号登录。

请求：{"account":"像素创意手作DIY"}（account 可空）

响应：{"ok":true,"context":{"groupid":"...","poi_id":"...","poi_name":"..."}}

请求参数：

请求示例：

curl -X POST https://hx.gxv.red/api/protocol/voucher/check \
  -H "Content-Type: application/json" \
  -d '{"account":"像素创意手作DIY","code":"123206286558914"}'

成功响应：

{
  "ok": true, "code": "123206286558914", "message": "验券成功",
  "product": "DIY拼豆 手工钥匙扣制作 钥匙链拼豆团购",
  "price": "9.0", "discount": "4.5折后价",
  "expire_time": 1817135999, "poi_name": "像素创意手作DIY",
  "verify_token": "63c8d445-...", "verify_scene_type": 8,
  "encrypted_codes": ["CgYIASAHKAESLgos..."],
  "raw": { ...完整响应... }
}

verify_token + encrypted_codes 可缓存，供核销接口直用（避免二次验券）。

请求参数：

方式 1：只传券码（自动先验后销）

curl -X POST https://hx.gxv.red/api/protocol/voucher/confirm \
  -H "Content-Type: application/json" \
  -d '{"account":"像素创意手作DIY","code":"123206286558914"}'

方式 2：传验券缓存的 token（直销，最快）

curl -X POST https://hx.gxv.red/api/protocol/voucher/confirm \
  -H "Content-Type: application/json" \
  -d '{"account":"像素创意手作DIY","code":"...",
       "verify_token":"63c8d445-...",
       "encrypted_codes":["CgYIASAHKAESLgos..."],
       "verify_scene_type":8}'

成功响应：

{
  "ok": true, "code": "123206286558914", "message": "核销成功",
  "certificate_id": "7670698934625452073",
  "order_id": "1110623717282294871",
  "item_order_id": "800000253488677610113364871",
  "product": "DIY拼豆 手工钥匙扣制作 钥匙链拼豆团购",
  "poi_name": "像素创意手作DIY", "can_cancel": true,
  "raw": {...}
}

请求：{"account":"像素创意手作DIY","verify_id":"7670698934625452073","certificate_id":"..."}

响应：{"ok":true,"message":"","status_code":0,"raw":{...}}