接入指南

SMSCode 提供 SMS-Activate 核心兼容接口，支持取号、取码、读取短信正文，以及完成和取消接码。接入端可以复用支持自定义接口地址的兼容客户端。

接口地址与认证

https://smscode.in/stubs/handler_api.php

支持 GET 查询参数和 POST application/x-www-form-urlencoded 表单。每次请求包含 api_key 和 action。API Key 由平台管理员分配，接码 ID 归属于申请时使用的 Key。

当前可申请资源

参数	值	含义
country	4	菲律宾
service	ot	全部短信，不按第三方网站筛选

手机号码为包含国际区号的数字字符串，例如 639123456789，不包含 +。仅分配当前在线且号码有效的资源，同一号码同时只供一个接码请求使用。

快速开始

将 API Key 放入环境变量 SMSCODE_API_KEY。

1. 申请号码

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

ACCESS_NUMBER:123:639123456789

保存接码 ID 123 与号码。有效期为申请成功后的 20 分钟，只读取申请成功后收到的短信。

2. 等待短信

将下面的 ID 换成申请结果，建议每 3 秒或更久 查询一次。

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

等待时返回 STATUS_WAIT_CODE；收到数字验证码后返回 STATUS_OK:123456。需要完整正文或普通短信时，使用 getStatusV2。

3. 完成或取消

完成使用后调用：

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

成功返回 ACCESS_ACTIVATION。放弃接码时将 status 改为 8，成功返回 ACCESS_CANCEL。两种操作都会释放号码；未主动结束的请求到期后释放。

客户端接入

将兼容客户端的完整接口地址配置为 https://smscode.in/stubs/handler_api.php，国家设为 4，服务设为 ot。

本接口支持的操作为 getCountries、getServices、getNumber、getStatus、getStatusV2、setStatus。计费、价格、余额、重发与长租操作不在当前协议范围内；需要这些操作才能运行的客户端应调整调用流程。

协议格式参考 SMS-Man Compatible API 与 DaisySMS API。