1. API 简介
全球短信验证码 API 提供自动化接码服务,支持:
获取虚拟手机号码
自动接收短信验证码
查询账户余额
释放号码
拉黑无效号码
多国家、多项目、多运营商支持
适用于:
Telegram
WhatsApp
Google
Facebook
Instagram
TikTok
Discord
其他短信验证平台
2. API 基础信息
API 地址
普通通道:https://x.com/api/
通道2:https://x.com/api2/
->通道2用户只需要把接口地址中的
/api/修改为/api2/<-
例如:
普通:https://x.com/api/get_mobile
通道2:https://x.com/api2/get_mobile
3. 请求说明
请求方式
所有接口均采用:GET
字符编码
UTF-8
请求限制
为了保证服务器稳定运行:
每次 API 请求间隔必须大于 2 秒
禁止频繁循环请求
禁止恶意占用服务器资源
如检测到:
高频请求
恶意攻击
自动化刷接口
消耗服务器资源
平台有权:
暂停账号限制接口清空余额不予退款
4. API 调用流程
完整流程:
登录账号↓获取 Token↓查询余额↓获取手机号码↓等待短信↓获取验证码↓释放号码 / 拉黑号码
一、账号登录接口
接口地址
https://x.com/api/login/
请求方式
GET
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | String | 是 | 用户账号 |
| password | String | 是 | 用户密码 |
请求示例
https://x.com/api/login/?username=test&password=123456
返回成功
{"code":200,"msg":"success","token":"abcdef123456789"}返回失败
{"code":400,"msg":"账号密码错误"}二、获取账户信息
接口地址
https://x.com/api/get_myinfo/
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| token | String | 是 | 登录返回Token |
请求示例
https://x.com/api/get_myinfo/?token=abcdef123456789
返回示例
{"code":200,"username":"test","balance":"100.00"}三、获取手机号码
接口地址
普通通道:
https://x.com/api/get_mobile
通道2:
https://x.com/api2/get_mobile
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| token | String | 是 | API Token |
| project_id | Int | 是 | 项目ID |
| operator | Int | 否 | 运营商 |
| phone_num | String | 否 | 指定号码或号段 |
| province | String | 否 | 指定省份 |
运营商参数
| 值 | 说明 |
|---|---|
| 0 | 不限 |
| 1 | 实体SIM卡 |
| 2 | 虚拟号码 |
示例
获取 Telegram 项目号码:
https://x.com/api/get_mobile?token=xxxx&project_id=1001
返回成功
{"code":200,"phone_num":"13800138000","project_id":"1001"}返回失败
{"code":400,"msg":"暂无号码"}四、获取短信验证码
接口地址
普通:
https://x.com/api/get_sms
通道2:
https://x.com/api2/get_sms
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| token | String | 是 | API Token |
| project_id | Int | 是 | 项目ID |
| phone_num | String | 是 | 手机号码 |
请求示例
https://x.com/api/get_sms?token=xxxx&project_id=1001&phone_num=13800138000
返回验证码
{"code":200,"sms":"568932"}等待短信
{"code":300,"msg":"等待短信"}五、释放号码
接口地址
普通:
https://x.com/api/release_phone
通道2:
https://x.com/api2/release_phone
参数
| 参数 | 类型 | 必填 |
|---|---|---|
| token | String | 是 |
| project_id | Int | 是 |
| phone_num | String | 是 |
示例
https://x.com/api/release_phone?token=xxxx&project_id=1001&phone_num=13800138000
返回
{"code":200,"msg":"释放成功"}六、拉黑号码
接口地址
普通:
https://x.com/api/black_phone
通道2:
https://x.com/api2/black_phone
参数
| 参数 | 类型 | 必填 |
|---|---|---|
| token | String | 是 |
| project_id | Int | 是 |
| phone_num | String | 是 |
示例
https://x.com/api/black_phone?token=xxxx&project_id=1001&phone_num=13800138000
返回
{"code":200,"msg":"拉黑成功"}7. 状态码说明
| Code | 说明 |
|---|---|
| 200 | 成功 |
| 300 | 等待短信 |
| 400 | 参数错误 |
| 401 | Token错误 |
| 402 | 余额不足 |
| 403 | 账号冻结 |
| 404 | 没有号码 |
| 405 | 项目不存在 |
8. PHP 调用示例
登录获取Token
<?php $url="/api/login/?username=test&password=123456"; $result=file_get_contents($url); $data=json_decode($result,true); $token=$data['token'];echo $token; ?>
获取号码
<?php $token="你的TOKEN"; $url="/api/get_mobile?token=".$token."&project_id=1001"; $result=file_get_contents($url);echo $result;?>
获取短信
<?php $url="/api/get_sms"; $url.="?token=".$token; $url.="&project_id=1001"; $url.="&phone_num=13800138000"; echo file_get_contents($url);?>
9. Javascript 示例
fetch("/api/get_mobile?token=xxxx&project_id=1001")
.then(res=>res.json())
.then(data=>{console.log(data);});10. Python 示例
import requestsurl="/api/get_mobile"
params={"token":"xxxx","project_id":1001}
r=requests.get(url,params=params)
print(r.json())11. 安全建议
Token 请勿公开
不要分享 API 密钥
建议服务器端调用 API
不建议客户端直接请求接口
定期更换密码
