短信验证码接口 · 对接文档

# 1) 发码（真实下发短信）
curl -X POST http://smsapi.wubadz.top/smsapi/v1/send \
  -H 'Content-Type: application/json' \
  -d '{"token":"sk_你的Token","phone":"13800138000"}'

# 2) 用户填码后校验 → 通过返回固定成功值
curl -X POST http://smsapi.wubadz.top/smsapi/v1/verify \
  -H 'Content-Type: application/json' \
  -d '{"token":"sk_你的Token","phone":"13800138000","code":"123456"}'
# {"code":0,"msg":"OK","data":{"result":"SUCCESS"}}

1. 快速开始

所有接口为 HTTP + JSON，基址 http://smsapi.wubadz.top，前缀统一为 /smsapi/v1/。已开启 CORS，浏览器前端可直接调用，无需后端转发。

2. 鉴权

每个接入方注册后获得唯一 sk_… 开头的 API Token，所有对外接口都需携带。建议由你自己的服务端转发调用，避免在前端源码里公开分发。

{"token":"sk_xxxxxxxxxxxxxxxxxxxxxxxx"}

3. 发送验证码

把用户手机号提交给接口，平台实时下发短信。注册、登录、绑定、找回/修改密码等场景复用同一接口，scene 只是你自己用来区分的标识，不影响发码行为。

POST /smsapi/v1/send
{
  "token": "sk_你的Token",
  "phone": "13800138000",       // 必填，11 位大陆手机号
  "scene": "register",          // 可选，自定义场景标识（register/login/bind/reset/forgot…），仅用于你自己的记录区分
  "session": "6f1c…"            // 可选，见下方「会话」说明
}

200 → {"code":0,"msg":"验证码已发送","data":{"session":"6f1c…","phone":"138****8000"}}

会话（可选）

不传 session 时，平台自动按「Token + 手机号」建会话，单机接入完全透明。若同一手机号多端并发（例如注册与登录同时发起），建议先调 /smsapi/v1/session 拿 session，后续两步都带上，避免串会话。

POST /smsapi/v1/session
{"token":"sk_你的Token","phone":"13800138000"}
200 → {"code":0,"data":{"session":"6f1c…","expires_in":1800}}

4. 校验验证码

用户填入收到的验证码后调用。校验通过返回你账号配置的固定成功值（默认 SUCCESS），你只需判断这个字段。

POST /smsapi/v1/verify
{"token":"sk_你的Token","phone":"13800138000","code":"123456"}
// 也可用 "session" 代替 "phone"

200 → {"code":0,"msg":"OK","data":{"result":"SUCCESS","session":"6f1c…","phone":"138****8000"}}
400 → {"code":1006,"msg":"验证码错误或已失效"}

5. 结果查询（可选）

校验通过后，平台后台仍会异步完成一次账号侧处理（约 60–90 秒）。该接口用于查询最终状态，你的登录/注册判定不需要等它。

GET /smsapi/v1/result?token=sk_你的Token&phone=13800138000
200 → {"code":0,"data":{"session":"…","state":"success","uid":"…","token_ready":true}}

6. 调用记录

GET /smsapi/v1/records?token=sk_你的Token&limit=50
200 → {"code":0,"data":{
  "summary":{"total":12,"success":9,"failed":1,"review":2,"sent":0,"created":0,"expired":0},
  "records":[{"session":"…","state":"success","phone":"138****8000","created":"2026-10-01 23:20:00"}]}}

同样可在会员中心查看：/console

7. 错误码

8. 场景示例

浏览器直调（已开 CORS）

const API = 'http://smsapi.wubadz.top';
const TOKEN = 'sk_你的Token';

async function sendCode(phone, scene) {
  const r = await fetch(API + '/smsapi/v1/send', {method:'POST',
    headers:{'Content-Type':'application/json'},
    body: JSON.stringify({token: TOKEN, phone, scene})}).then(r => r.json());
  if (r.code) throw new Error(r.msg);
}

async function checkCode(phone, code) {
  const r = await fetch(API + '/smsapi/v1/verify', {method:'POST',
    headers:{'Content-Type':'application/json'},
    body: JSON.stringify({token: TOKEN, phone, code})}).then(r => r.json());
  return r.code === 0 && r.data && r.data.result;   // 返回固定成功值即通过
}

服务端（PHP 示例）

$ch = curl_init('http://smsapi.wubadz.top/smsapi/v1/verify');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode(['token' => $TOKEN, 'phone' => $phone, 'code' => $code]),
]);
$r = json_decode(curl_exec($ch), true);
if ($r['code'] === 0 && !empty($r['data']['result'])) { /* 校验通过 */ }

9. 接入方账号：手机号注册 / 登录

本平台的接入方账号同样使用手机号 + 短信验证码注册与登录，无需设置密码：

10. 规则与限额

11. 常见问题

① 为什么校验成功却查不到 result？

请先看 /smsapi/v1/verify 的同步返回（data.result）；/result 反映的是异步的最终状态。

② 同一个手机号会不会串？

不会。平台按「Token + 手机号」隔离会话；多端并发建议显式使用 session。

③ 返回 429 / 1009 怎么办？

当日额度用尽。会员中心可看今日用量，或联系平台方提升上限。

④ 接入方账号怎么注册？

手机号 + 短信验证码即可，不需要密码：注册 / 登录。

⑤ 接口收费吗？

注册即可免费调用，先测通再谈用量。额度与频控以你账号页面显示为准。

⑥ 能否自定义短信内容？

短信内容由通道方统一下发，接入方不能自定义模板；平台负责把手机号提交给通道并回传校验结果。