开发者 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

需要密钥

按国家和服务查询价格与库存:有多少号码、什么价格。

参数
参数类型必填说明
actionstring必填方法名称:getPrices
api_keystring必填后台中的访问密钥
countrystring否国家标识,例如 43
servicestring否服务代码,例如 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

需要密钥

国家字典:标识、名称以及该国支持哪些模式。

参数
参数类型必填说明
actionstring必填方法名称:getCountries
api_keystring必填后台中的访问密钥
请求
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 }
}
rus、eng 和 chn 字段目前返回的是两位 ISO 国家代码,而不是国家名称。
可能的响应
BAD_KEY密钥无效:不存在或已吊销

getServicesList

需要密钥

服务字典:服务代码及其名称。

参数
参数类型必填说明
actionstring必填方法名称:getServicesList
api_keystring必填后台中的访问密钥
countrystring否国家标识,例如 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" }
  ]
}
带 country 参数时,列表只保留该国实际在售的服务。
可能的响应
BAD_COUNTRY未找到该国家
BAD_KEY密钥无效:不存在或已吊销

getBalance

需要密钥

账户余额。

参数
参数类型必填说明
actionstring必填方法名称:getBalance
api_keystring必填后台中的访问密钥
请求
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getBalance&api_key=YOUR_API_KEY
响应
ACCESS_BALANCE:12.50
响应是字符串而非 JSON:金额在冒号之后。
可能的响应
BAD_KEY密钥无效:不存在或已吊销

getNumber

需要密钥

下单取号。响应里带激活 id 和号码。

参数
参数类型必填说明
actionstring必填方法名称:getNumber
api_keystring必填后台中的访问密钥
countrystring必填国家标识,例如 43
servicestring必填服务代码,例如 wa
durationstring否订单时长:activation — 一次性激活(默认);d1、d3、d7 — 租用号码 1、3 或 7 天
maxPricestring否每个号码的价格上限。高于此价格不会购买:将返回 WRONG_MAX_PRICE 或 NO_NUMBERS,而不是订单
softIdstring否软件标识,最长 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
响应是字符串 ACCESS_NUMBER:id:号码。id 用于 getStatus 和 setStatus。 不传 duration 时下单一次性激活。传 duration=d1、d3 或 d7 时号码为租用,租期结束前都会出现在 getCurrentActivationsList 中。服务没有该时长时,响应为 BAD_SERVICE。如果传了 maxPrice 且租用价格高于该上限,响应为 NO_NUMBERS,不附最低价:WRONG_MAX_PRICE:价格 只在 activation 时返回。
可能的响应
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,带价格、国家和激活时间。

参数
参数类型必填说明
actionstring必填方法名称:getNumberV2
api_keystring必填后台中的访问密钥
countrystring必填国家标识,例如 43
servicestring必填服务代码,例如 wa
durationstring否订单时长:activation — 一次性激活(默认);d1、d3、d7 — 租用号码 1、3 或 7 天
maxPricestring否每个号码的价格上限。高于此价格不会购买:将返回 WRONG_MAX_PRICE 或 NO_NUMBERS,而不是订单
softIdstring否软件标识,最长 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"
}
与 getNumber 的区别只在成功响应。activationTime 为 UTC 时间。拒绝响应与 getNumber 一样,是纯文本字符串,而不是 JSON。
可能的响应
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

需要密钥

激活状态:仍在等验证码,还是验证码已到。

参数
参数类型必填说明
actionstring必填方法名称:getStatus
api_keystring必填后台中的访问密钥
idstring必填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

需要密钥

该密钥下的活跃订单:仍在等待验证码或已收到验证码的号码。

参数
参数类型必填说明
actionstring必填方法名称:getCurrentActivationsList
api_keystring必填后台中的访问密钥
请求
GET https://sim-aggregator.org/stubs/handler_api.php
  ?action=getCurrentActivationsList&api_key=YOUR_API_KEY
响应
[
  {
    "numberid": 12345,
    "number": "380991234567",
    "status": 0
  }
]
扁平 JSON 数组。status:0 — 等待验证码,3 — 已收到验证码;已关闭的订单不在列表中。没有活跃订单时返回空数组 []。
可能的响应
BAD_KEY密钥无效:不存在或已吊销
ERROR_API服务端出现意外错误

setStatus

需要密钥

变更激活:再要一条验证码、结束或取消。

参数
参数类型必填说明
actionstring必填方法名称:setStatus
api_keystring必填后台中的访问密钥
idstring必填getNumber 返回的激活 id
statusstring必填激活的新状态: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 秒一次