SMS Rooms — Virtual Numbers for SMS Verification

API 文档

支持 POST 和 GET 请求。

请求必须包含 API 密钥作为参数 api_key

API 请求地址: https://sms-rooms.com/stubs/handler_api.php

获取号码

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country&ref=$ref&maxPrice=$maxPrice

参数:

$api_key您的 API 密钥
$service要订购的服务
$country号码国家
$ref账户 ID(可选)
$maxPrice最高价格(可选)

响应:

ACCESS_NUMBER:$activationId:$phoneNumber

请求示例:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=187&maxPrice=5

响应::

ACCESS_NUMBER:2887:17744056708

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确
BAD_SERVICE - 服务名称不正确
BAD_COUNTRY - 国家名称不正确
NO_BALANCE - 余额不足
NO_NUMBERS - 没有可用号码

检查激活状态

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

参数:

$api_key您的 API 密钥
$id在 getNumber 中收到的激活 ID

响应:

STATUS_OK:'短信验证码' 或 STATUS_WAIT_CODE

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确
NO_ACTIVATION - 激活 ID 不存在

检查余额

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

参数:

$api_key您的 API 密钥

响应:

ACCESS_BALANCE:'账户余额'

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确

更改激活状态

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

参数:

$api_key您的 API 密钥
$id激活 ID
$status状态:1-就绪,3-再次请求,6-完成,8-取消

响应:

ACCESS_READY / ACCESS_ACTIVATION / ACCESS_CANCEL / ACCESS_RETRY_GET

请求示例:

https://sms-rooms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&status=3&id=2887

响应::

ACCESS_RETRY_GET

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确
NO_ACTIVATION - 激活 ID 不存在
BAD_STATUS - 状态不正确

服务列表

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getServicesList

参数:

$api_key您的 API 密钥

响应:

{"code": "服务 ID", "name": "服务名称"}

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确

国家列表

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getCountries

参数:

$api_key您的 API 密钥

响应:

{"id": "国家 ID", "rus": "俄语名称", "eng": "英语名称"}

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确

号码数量

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

参数:

$api_key您的 API 密钥
$country号码国家

响应:

{"service_code": "numbers_count"}

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确
BAD_COUNTRY - 国家名称不正确

价格列表

请求:

https://sms-rooms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

参数:

$api_key您的 API 密钥
$service要订购的服务(可选)
$country号码国家(可选)

响应:

{"国家代码": {"服务代码": {"价格": 数量}}}

错误:

BAD_KEY - 无效的 API 密钥
BAD_ACTION - 操作不正确
BAD_COUNTRY - 国家名称不正确
BAD_SERVICE - 服务名称不正确