开发者 API
公开 API 只有一个端点、只用 GET 请求:方法名放在 action 参数里。格式与主流平台兼容,现成代码只要改基础 URL 就能跑。
基础 URL
GEThttps://sim-aggregator.org/stubs/handler_api.php
所有方法都调用这个地址,区别只在 action 参数。调用顺序
1getPrices · getServicesList查询所需服务和国家的价格与库存。
2getNumber · getNumberV2下单取号:响应里带激活 id 和号码本身。
3getStatus轮询状态,直到验证码到达。
4setStatus · 6服务接受验证码后结束激活。
—setStatus · 3 · 8需要再来一条验证码用 3;号码没用上用 8,金额退回。
方法一览
| 方法 | 密钥 | 参数 |
|---|---|---|
| getPrices | 需要密钥 | action, api_key, [country], [service] |
| getCountries | 需要密钥 | action, api_key |
| getServicesList | 需要密钥 | action, api_key, [country] |
| getBalance | 需要密钥 | action, api_key |
| getNumber | 需要密钥 | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getNumberV2 | 需要密钥 | action, api_key, country, service, [duration], [maxPrice], [softId] |
| getStatus | 需要密钥 | action, api_key, id |
| getCurrentActivationsList | 需要密钥 | action, api_key |
| setStatus | 需要密钥 | action, api_key, id, status |
getPrices
需要密钥按国家和服务查询价格与库存:有多少号码、什么价格。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getPrices |
| api_key | string | 必填 | 后台中的访问密钥 |
| country | string | 否 | 国家标识,例如 43 |
| service | string | 否 | 服务代码,例如 wa |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getPrices&api_key=YOUR_API_KEY&country=43
响应
{
"43": {
"wa": { "cost": 0.5, "count": 100 },
"tg": { "cost": 0.71, "count": 250 }
}
}可能的响应
BAD_COUNTRY未找到该国家
BAD_SERVICE未找到该服务
BAD_KEY密钥无效:不存在或已吊销
getCountries
需要密钥国家字典:标识、名称以及该国支持哪些模式。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getCountries |
| api_key | string | 必填 | 后台中的访问密钥 |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCountries&api_key=YOUR_API_KEY
响应
{
"43": { "id": 43, "rus": "DE", "eng": "DE", "chn": "DE",
"visible": 1, "retry": 1, "rent": 0, "multiService": 0 }
}可能的响应
BAD_KEY密钥无效:不存在或已吊销
getServicesList
需要密钥服务字典:服务代码及其名称。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getServicesList |
| api_key | string | 必填 | 后台中的访问密钥 |
| country | string | 否 | 国家标识,例如 43 |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getServicesList&api_key=YOUR_API_KEY
响应
{
"status": "success",
"services": [
{ "code": "tg", "name": "Telegram" },
{ "code": "wa", "name": "WhatsApp" }
]
}可能的响应
BAD_COUNTRY未找到该国家
BAD_KEY密钥无效:不存在或已吊销
getBalance
需要密钥账户余额。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getBalance |
| api_key | string | 必填 | 后台中的访问密钥 |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getBalance&api_key=YOUR_API_KEY
响应
ACCESS_BALANCE:12.50
可能的响应
BAD_KEY密钥无效:不存在或已吊销
getNumber
需要密钥下单取号。响应里带激活 id 和号码。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getNumber |
| api_key | string | 必填 | 后台中的访问密钥 |
| country | string | 必填 | 国家标识,例如 43 |
| service | string | 必填 | 服务代码,例如 wa |
| duration | string | 否 | 订单时长:activation — 一次性激活(默认);d1、d3、d7 — 租用号码 1、3 或 7 天 |
| maxPrice | string | 否 | 每个号码的价格上限。高于此价格不会购买:将返回 WRONG_MAX_PRICE 或 NO_NUMBERS,而不是订单 |
| softId | string | 否 | 软件标识,最长 255 个字符 |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumber&api_key=YOUR_API_KEY&country=43&service=wa
响应
ACCESS_NUMBER:12345:380991234567
可能的响应
NO_BALANCE余额不足以下单
NO_NUMBERS该组合当前没有空闲号码
BAD_COUNTRY未找到该国家
BAD_SERVICE未找到该服务
BAD_DURATIONduration 取值未知
WRONG_MAX_PRICE:PRICE价格高于 maxPrice;冒号后是该组合的最低价格(仅限一次性激活)
BAD_MAX_PRICEmaxPrice 不是数字或不大于零
BAD_KEY密钥无效:不存在或已吊销
CHANNEL_LIMIT已达到同时激活数量上限
BAD_SOFTWARE_IDsoftId 不合法
ERROR_API服务端出现意外错误
getNumberV2
需要密钥下单取号,与 getNumber 相同,但成功响应是 JSON,带价格、国家和激活时间。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getNumberV2 |
| api_key | string | 必填 | 后台中的访问密钥 |
| country | string | 必填 | 国家标识,例如 43 |
| service | string | 必填 | 服务代码,例如 wa |
| duration | string | 否 | 订单时长:activation — 一次性激活(默认);d1、d3、d7 — 租用号码 1、3 或 7 天 |
| maxPrice | string | 否 | 每个号码的价格上限。高于此价格不会购买:将返回 WRONG_MAX_PRICE 或 NO_NUMBERS,而不是订单 |
| softId | string | 否 | 软件标识,最长 255 个字符 |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getNumberV2&api_key=YOUR_API_KEY&country=43&service=wa
响应
{
"activationId": 12345,
"phoneNumber": "380991234567",
"activationCost": 0.50,
"currency": 840,
"countryCode": "43",
"canGetAnotherSms": "1",
"activationTime": "2026-07-31 12:00:00",
"activationOperator": "any"
}可能的响应
NO_BALANCE余额不足以下单
NO_NUMBERS该组合当前没有空闲号码
BAD_COUNTRY未找到该国家
BAD_SERVICE未找到该服务
BAD_DURATIONduration 取值未知
WRONG_MAX_PRICE:PRICE价格高于 maxPrice;冒号后是该组合的最低价格(仅限一次性激活)
BAD_MAX_PRICEmaxPrice 不是数字或不大于零
BAD_KEY密钥无效:不存在或已吊销
CHANNEL_LIMIT已达到同时激活数量上限
BAD_SOFTWARE_IDsoftId 不合法
ERROR_API服务端出现意外错误
getStatus
需要密钥激活状态:仍在等验证码,还是验证码已到。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getStatus |
| api_key | string | 必填 | 后台中的访问密钥 |
| id | string | 必填 | getNumber 返回的激活 id |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getStatus&api_key=YOUR_API_KEY&id=12345
响应
STATUS_OK:123456
可能的响应
STATUS_WAIT_CODE号码已发放,验证码尚未到达
STATUS_OK:CODE已收到验证码,末尾是短信中的验证码
STATUS_WAIT_RETRY:CODE等待下一个验证码;末尾是上一个验证码
STATUS_CANCEL激活已关闭:已取消或已完成
NO_ACTIVATION激活不存在或已关闭
BAD_KEY密钥无效:不存在或已吊销
getCurrentActivationsList
需要密钥该密钥下的活跃订单:仍在等待验证码或已收到验证码的号码。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:getCurrentActivationsList |
| api_key | string | 必填 | 后台中的访问密钥 |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getCurrentActivationsList&api_key=YOUR_API_KEY
响应
[
{
"numberid": 12345,
"number": "380991234567",
"status": 0
}
]可能的响应
BAD_KEY密钥无效:不存在或已吊销
ERROR_API服务端出现意外错误
setStatus
需要密钥变更激活:再要一条验证码、结束或取消。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | 方法名称:setStatus |
| api_key | string | 必填 | 后台中的访问密钥 |
| id | string | 必填 | getNumber 返回的激活 id |
| status | string | 必填 | 激活的新状态:3、6 或 8 |
请求
GET https://sim-aggregator.org/stubs/handler_api.php ?action=setStatus&api_key=YOUR_API_KEY&id=12345&status=6
响应
ACCESS_ACTIVATION
status 取值
3在同一号码上再要一条验证码
6结束激活:验证码已被接受
8取消激活,金额退回余额
可能的响应
ACCESS_ACTIVATION激活已结束
ACCESS_CANCEL激活已取消,金额已退回
ACCESS_RETRY_GET请求已受理:等待同一号码的下一个验证码
NO_ACTIVATION激活不存在或已关闭
EARLY_CANCEL_DENIED现在取消还太早,请稍后重试
BAD_STATUS不允许:激活已关闭,或验证码已下发,无法取消
BAD_KEY密钥无效:不存在或已吊销
ERROR_API服务端出现意外错误
通用错误
BAD_ACTIONaction 中的方法名未知
BAD_KEY密钥无效:不存在或已吊销
NO_BALANCE余额不足以下单
NO_NUMBERS该组合当前没有空闲号码
BAD_COUNTRY未找到该国家
BAD_SERVICE未找到该服务
CHANNEL_LIMIT已达到同时激活数量上限
REQUEST_LIMIT超出每个密钥的请求上限,请稍候重试
BAD_SOFTWARE_IDsoftId 不合法
BAD_STATUSstatus 取值不被支持
ERROR_API服务端出现意外错误
服务代码完整列表见 getServicesList
waWhatsApp
tgTelegram
vkVK
goGoogle
fbFacebook
lfTikTok
igInstagram
dsDiscord
drOpenAI
aczClaude
国家代码完整列表见 getCountries
43德国
15波兰
16英国
78法国
86意大利
56西班牙
2哈萨克斯坦
62土耳其
187美国
22印度
限制
每个密钥的请求数每分钟 600 次(约每秒 10 次)
状态轮询每个激活每 2–5 秒一次