大多数接口返回 JSON，注册验证码接口返回 SVG 图片；成功 HTTP 200，失败返回对应状态码和 error 字段
本系统支持两种鉴权方式：① Cookie Session（浏览器/支持Cookie的HTTP客户端）② Bearer Token（脚本/自动化工具推荐）。登录接口同时返回 Cookie 和 token，选其一即可。
token 字段，后续请求在 Header 中添加 Authorization: Bearer {token} 即可。Token 有效期 24 小时，修改密码后立即失效。
每种 type 在 /api/get-phone、/api/verify、/api/sms/import 中使用方式不同，下面给出完整的请求体示例
| type 代码 | 中文名 |
|---|---|
| risk | 风险验证 |
| safe | 安全手机 |
| safe_new | 新安全手机 |
| alphanum | 字母数字 |
| change_safe_phone | 更换安全手机 |
| mobile | 手游 |
| change_password | 修改密码 |
safe / safe_new / alphanum / change_safe_phone 任一类型的发码，才能调用 /api/sms/import；并且 phone 必须是自己曾经发码 success 过的号码。risk / mobile / change_password 这三种类型本身不能作为接码前置条件。
所有错误返回格式为 { "error": "原因描述" }，HTTP 状态码见下表
| HTTP | 含义 | 典型 error 内容 |
|---|---|---|
| 400 | 参数/业务校验失败 | 余额不足 / 手机号格式错误 / 请先获取图形验证码 / 接码号码必须是您发码成功的号码 |
| 401 | 未登录或登录失效 | 未登录 / token无效或已过期 / 密码已修改，请重新登录 / 账号已被封禁 |
| 404 | 资源不存在 | 任务不存在 / 用户不存在 |
| 429 | 限流 | 登录失败次数过多 / 注册过于频繁 |
| 500 | 服务器错误 | 三方接口异常 / 数据库错误（一般可重试） |
"kicked": true 和 "scope": "user"|"admin"，客户端应据此清空本地登录态。
登录成功后服务器返回 Set-Cookie，后续所有需登录接口必须携带该 Cookie；账号 ID 支持纯数字或字母数字字符串
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| {{ p.name }} | {{ p.type }} | {{ p.required?'是':'否' }} | {{ p.desc }} |
查询余额、卡密充值、用户资料等钱包相关接口
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| {{ p.name }} | {{ p.type }} | {{ p.required?'是':'否' }} | {{ p.desc }} |
发码是异步任务：先取号，再创建发码任务，最后轮询状态接口直到 success/failed
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| {{ p.name }} | {{ p.type }} | {{ p.required?'是':'否' }} | {{ p.desc }} |
接收短信验证码，需要余额和接码权限
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| {{ p.name }} | {{ p.type }} | {{ p.required?'是':'否' }} | {{ p.desc }} |
完整的登录 → 取号 → 发码 → 查状态流程，支持 curl / Java / 易语言 / 懒人精灵
POST 请求登录接口，-c 保存 Cookie 到文件
-b 读取之前保存的 Cookie 文件
获取一个可用手机号，返回 phone 和 com。type 这里用 safe（安全手机），它能同时用于发码和接码
创建发码任务并异步发送，需继续轮询状态；最终 success 后扣费 1 元
轮询任务状态，直到返回 success 或 failed（建议间隔 2 秒）
发码 success 后调接码接口，必须用同一个 phone 和 type；count>0 时扣 1 元
使用 OkHttp + CookieJar 自动管理 Cookie
CookieJar 会自动保存并在后续请求中发送 Cookie
自动携带 Cookie，无需手动处理。type 用 safe（安全手机），能同时用于发码和接码
每 2 秒查一次，直到 status=success 或 failed，最多 30 秒
必须用刚发码的 phone 和同样的 type；count>0 时扣 1 元
使用网页访问对象（精易模块或系统自带）
注意 JSON 用 UTF-8 编码提交，不要用 GBK
每次请求都要带上登录时获取的 Cookie
application/json 和 application/x-www-form-urlencoded 两种格式。懒人精灵推荐使用 Token 认证 + 表单格式，无需处理 Cookie。
登录后从返回的 JSON 中提取 token，后续所有请求在 Header 带上 Authorization: Bearer token
带 Token 请求取号接口，解析返回的 phone
表单提交发码请求，带 Token 认证
GET 请求轮询，每2秒查一次，直到 success 或 failed（此接口无需登录）
发码成功后查收验证码短信，需带 Token
上面 4 种语言示例统一用 safe（最简单，能直接跑通）。如果你要用其他 type，只需把请求中的 type 字段替换成下面对应的值，并按"必填字段"加上参数即可
| 用途 | type 值 | 取号 body | 发码 body（最小） | 能接码? |
|---|---|---|---|---|
| 风险验证 | risk |
{"type":"risk"} |
{"type":"risk","phone":"取号返回的phone"} |
❌ 不能作前置 |
| 安全手机 | safe |
{"type":"safe"} |
{"type":"safe","phone":"取号返回的phone"} |
✅ 可接码 |
| 新安全手机 | safe_new |
{"type":"safe_new"} |
{"type":"safe_new","phone":"取号返回的phone"} |
✅ 可接码 |
| 字母数字 | alphanum |
{"type":"alphanum"} |
{"type":"alphanum","phone":"取号phone","verify_code":"ABCD1234"} |
✅ 可接码 |
| 更换安全手机 | change_safe_phone |
{"type":"change_safe_phone"} |
{"type":"change_safe_phone","phone":"11位手机号"} |
✅ 可接码 |
| 手游 | mobile |
{"type":"mobile"} |
{"type":"mobile","phone":"取号phone","verify_code":"888888"} |
❌ 不能作前置 |
| 修改密码 | change_password |
{"type":"change_password"} |
{"type":"change_password","phone":"11位手机号"} |
❌ 不能作前置 |
alphanum 和 mobile。verify_code 的内容就是要发送的短信正文（自己定，例如 "ABCD1234" 或 "888888"）。change_safe_phone 和 change_password。其他 type 的 phone 可省略，但建议透传取号接口返回的 phone 以保证接码绑定。safe / safe_new / alphanum / change_safe_phone。如果你要用 risk/mobile/change_password 接码，必须先用上面 4 种之一发码成功一次（管理员豁免）。
Content-Type: application/json）和表单（application/x-www-form-urlencoded）两种格式；② 认证方式二选一：Cookie 或 Bearer Token（推荐脚本使用 Token）；③ Token 有效期 24 小时，修改密码后失效；④ 发码成功后扣费 1 元，请确保余额充足；⑤ 查询状态建议间隔 2 秒轮询，避免过于频繁。
点击其他标签页的接口可自动填充到调试器。登录接口调试成功后浏览器自动保存 Cookie。