接口参考

全部操作使用同一个接口地址，并携带 api_key。业务响应通常使用 HTTP 200；文本状态直接按字符串解析，JSON 响应按 JSON 解析。

getCountries：国家列表

参数：action=getCountries。

[{"id":4,"name":"菲律宾","name_en":"Philippines"}]

getServices：服务列表

参数：action=getServices。

[{"id":"ot","name":"全部短信"}]

getNumber：申请号码

参数	必填	值
action	是	getNumber
service	是	ot
country	否	4，默认菲律宾

ACCESS_NUMBER:123:639123456789

字段依次为成功标识、接码 ID、手机号码。接码有效期为 20 分钟。同一号码在请求结束前独占，申请失败返回 NO_NUMBERS 或其他错误状态。

getStatus：查询验证码

参数：action=getStatus&id=123。

响应	含义
STATUS_WAIT_CODE	等待数字验证码
STATUS_OK:123456	已收到验证码
STATUS_CANCEL	已取消、已过期，或结束前未读取短信
NO_ACTIVATION	ID 不存在，或不属于当前 API Key

验证码按短信中独立数字段提取，长度为 4～8 位。存在多个匹配数字段时使用正文中第一个。普通短信不包含匹配数字段时，仍返回 STATUS_WAIT_CODE，可改用 getStatusV2 读取正文。

建议轮询间隔至少 3 秒。收到所需结果后调用 setStatus 结束接码。

getStatusV2：读取短信正文

参数：action=getStatusV2&id=123。

存在短信时返回：

{
  "verificationType": 0,
  "sms": {
    "dateTime": "2026-10-22 14:00:00",
    "code": "123456",
    "text": "Your verification code is 123456"
  }
}

dateTime 为短信来源提供的时间字符串。普通短信的 code 为空字符串，text 保留完整正文。存在多条短信时优先返回含验证码的最新短信，否则返回最新普通短信。

尚未收到短信时返回文本 STATUS_WAIT_CODE；取消或到期时返回 STATUS_CANCEL。调用端应先识别这些文本状态，再解析 JSON。

setStatus：结束或确认接码

参数：action=setStatus&id=123&status=6。

status	操作	成功响应
1	确认号码就绪，可省略	ACCESS_READY
6	完成接码，释放号码	ACCESS_ACTIVATION
8 或 -1	取消接码，释放号码	ACCESS_CANCEL

重复执行相同的完成或取消操作返回相同的成功响应。已结束的请求不能切换为另一种结束状态。完成后保留最后查询到的短信结果，后续收到的短信不会进入这个已完成请求。

取消和到期后查询返回 STATUS_CANCEL。再次接码需要重新申请号码。status=3 重发操作返回 BAD_STATUS。