WhatsApp 接码

WhatsApp 服务使用 service=wa，当前支持菲律宾 country=4。专用 API Key 可申请全部在线可用号码，仅授权 WhatsApp 服务。

申请号码

将专用 Key 放入环境变量 SMSCODE_WHATSAPP_API_KEY。

curl --silent --show-error \
  'https://smscode.in/stubs/handler_api.php' \
  --data-urlencode "api_key=$SMSCODE_WHATSAPP_API_KEY" \
  --data 'action=getNumber&service=wa&country=4'

ACCESS_NUMBER:123:639123456789

保存接码 ID 和号码。有效期为 20 分钟，同一号码同时只能由一个接码请求使用，其他服务也遵循这个占用规则。

获取验证码

按接码 ID 轮询，间隔至少 3 秒：

curl --silent --show-error \
  'https://smscode.in/stubs/handler_api.php' \
  --data-urlencode "api_key=$SMSCODE_WHATSAPP_API_KEY" \
  --data 'action=getStatus&id=123'

等待时返回 STATUS_WAIT_CODE，收到验证码时返回 STATUS_OK:123456。

wa 只返回发送方或正文含独立 WhatsApp 标识的短信，标识匹配忽略大小写。验证码支持连续六位数字和 123-456、123 456 等三位分组格式，统一返回六位数字字符串。该标识用于分类，不代表对发送方身份的认证。

使用 action=getStatusV2&id=123 可读取完整短信：

{
  "verificationType": 0,
  "sms": {
    "dateTime": "2026-10-22 14:00:00",
    "code": "123456",
    "text": "Your WhatsApp code: 123-456"
  }
}

含 WhatsApp 标识但没有有效验证码的短信，code 为空字符串，getStatus 继续返回 STATUS_WAIT_CODE。

完成与重复接码

curl --silent --show-error \
  'https://smscode.in/stubs/handler_api.php' \
  --data-urlencode "api_key=$SMSCODE_WHATSAPP_API_KEY" \
  --data 'action=setStatus&id=123&status=6'

完成后返回 ACCESS_ACTIVATION 并释放号码。放弃时使用 status=8，返回 ACCESS_CANCEL。

释放后的号码允许再次分配，适用于重复登录测试。每次申请生成新的接码 ID，只读取新申请之后收到的短信；后续申请按当时可用号池分配。已完成请求保留最后查询到的结果。

Key 权限

getServices 仅列出当前 Key 获得授权的服务。WhatsApp 专用 Key 返回：

[{"id":"wa","name":"WhatsApp"}]

使用该 Key 申请 ot 或其他未授权服务时返回 BAD_SERVICE。不同 API Key 的接码 ID 互相隔离，即使另一个 Key 也拥有 WhatsApp 服务权限。