API для разработчиков
Публичный API — один эндпоинт и только GET-запросы: имя метода передаётся параметром action. Формат совместим с популярными площадками, поэтому готовый код начинает работать после смены базового URL.
| Метод | Ключ | Параметры |
|---|---|---|
| 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 }
}
}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 }
}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" }
]
}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
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
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"
}getStatus
нужен ключСтатус активации: ждём код или код уже пришёл.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| action | string | обязательный | Название метода: getStatus |
| api_key | string | обязательный | Ключ доступа из кабинета |
| id | string | обязательный | Идентификатор активации из getNumber |
GET https://sim-aggregator.org/stubs/handler_api.php ?action=getStatus&api_key=YOUR_API_KEY&id=12345
STATUS_OK:123456
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
}
]setStatus
нужен ключИзменить состояние активации: запросить ещё код, завершить или отменить.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| action | string | обязательный | Название метода: setStatus |
| api_key | string | обязательный | Ключ доступа из кабинета |
| id | string | обязательный | Идентификатор активации из getNumber |
| 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