OTP API
Документация (RU) ▼
Базовый URL: https://sms-acktiwator.ru/api/otp/
Метод: GET или POST (параметры можно передавать query string или form-urlencoded).
Параметры: основной параметр — action (название метода).
Авторизация: для защищённых методов требуется параметр key (ваш API‑ключ из раздела API).
Лимиты: защищённые методы — 50 запросов/минуту на ключ; getPrices — 10 запросов/минуту (без ключа — по IP, с ключом — по ключу).
1) getPrices
Назначение: актуальные цены и количество доступных номеров по странам и сервисам.
Параметры:
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
action | строка | да | getPrices |
Запрос:
https://sms-acktiwator.ru/api/otp/?action=getPrices
Ответ: JSON вида { "Country_ID": { "Service_Code": { "cost": "0.50", "count": 100 } } }
{
"1": {
"wa": { "cost": "0.50", "count": 100 },
"tg": { "cost": "0.71", "count": 250 }
}
}
2) getCountries
Назначение: список поддерживаемых стран (ID и названия).
Параметры:
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
action | строка | да | getCountries |
Запрос:
https://sms-acktiwator.ru/api/otp/?action=getCountries
Ответ: JSON (ключ — ID страны):
{
"43": { "id": 43, "rus": "Германия", "eng": "Germany", "chn": "德国", "visible": 1 }
}
3) getServicesList
Назначение: список сервисов (код + отображаемое название).
Параметры:
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
action | строка | да | getServicesList |
Запрос:
https://sms-acktiwator.ru/api/otp/?action=getServicesList
Ответ: JSON:
{
"status": "success",
"services": [
{ "id": "1", "code": "wa", "name": "WhatsApp" },
{ "id": "2", "code": "tg", "name": "Telegram" }
]
}
4) getBalance (требует key)
Назначение: вернуть баланс пользователя в системе.
Параметры:
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
action | строка | да | getBalance |
key | строка | да | Ваш API‑ключ |
Запрос:
https://sms-acktiwator.ru/api/otp/?action=getBalance&key=YOUR_API_KEY
Ответ (text/plain):
ACCESS_BALANCE:12.50
Ошибки:
BAD_KEY— ключ не указан, неверный или отключён.CHANNEL_LIMIT— превышен лимит запросов (50/мин на ключ).
5) getNumber (требует key)
Назначение: заказать номер для приёма SMS.
Параметры:
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
action | строка | да | getNumber |
key | строка | да | Ваш API‑ключ |
country | строка (число) | да | ID страны (пример: 43) |
service | строка | да | Код сервиса (пример: wa) |
key— API‑ключ (обяз.)country— ID страны (обяз., числовая строка)service— код сервиса (обяз., напримерwa,tg,vk,fb)
Запрос:
https://sms-acktiwator.ru/api/otp/?action=getNumber&key=YOUR_API_KEY&country=43&service=wa
Ответ (text/plain):
ACCESS_NUMBER:12345:380991234567
Ошибки:
BAD_KEY— ключ не указан, неверный или отключён.BAD_COUNTRY— страна не указана или country не найден.BAD_SERVICE— сервис не указан или не поддерживается.NO_BALANCE— недостаточно средств на балансе пользователя.NO_NUMBERS— нет доступных номеров по указанным параметрам.CHANNEL_LIMIT— превышен лимит запросов (50/мин на ключ).UNKNOWN_ERROR— внутренняя ошибка сервера.
6) getStatus (требует key)
Назначение: проверить, получено ли SMS и код.
Параметры:
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
action | строка | да | getStatus |
key | строка | да | Ваш API‑ключ |
activationId | строка (число) | да | ID активации из getNumber |
Запрос:
https://sms-acktiwator.ru/api/otp/?action=getStatus&key=YOUR_API_KEY&activationId=12345
Ответы (text/plain):
STATUS_WAIT_CODE— код ещё не полученSTATUS_OK:123456— код полученNO_ACTIVATION— активация не найдена / истеклаBAD_KEY— неверный ключ
Расшифровка:
STATUS_WAIT_CODE— ожидайте: повторите запрос через несколько секунд.STATUS_OK:CODE— код получен, можно завершать активацию черезsetStatusсоstatus=6.NO_ACTIVATION— активация не найдена у данного пользователя или истекла/закрыта.BAD_KEY— ключ не указан, неверный или отключён.
7) setStatus (требует key)
Назначение: изменить статус активации.
Параметры:
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
action | строка | да | setStatus |
key | строка | да | Ваш API‑ключ |
activationId | строка (число) | да | ID активации |
status | строка (число) | да | Новый статус: 3, 6 или 8 |
Значения status:
3— запросить ещё одно SMS6— завершить активацию8— отменить активацию
Запрос:
https://sms-acktiwator.ru/api/otp/?action=setStatus&key=YOUR_API_KEY&activationId=12345&status=6
Ответы (text/plain):
ACCESS_ACTIVATION— активация завершена.ACCESS_CANCEL— активация отменена.STATUS_WAIT_CODE— запрос на повторную SMS принят.NO_ACTIVATION— активация не найдена.BAD_KEY— ключ не указан, неверный или отключён.BAD_STATUS— неверное значениеstatusили некорректные параметры.
Documentation (EN) ▼
Base URL: https://sms-acktiwator.ru/api/otp/
Method: GET or POST (parameters can be sent via query string or form-urlencoded body).
Parameters: main parameter is action (method name).
Auth: protected methods require key (your API key from the API page).
Limits: protected methods — 50 requests/minute per key; getPrices — 10 requests/minute (without key — per IP, with key — per key).
1) getPrices
Purpose: current prices and available number counts by countries and services.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | yes | getPrices |
Request:
https://sms-acktiwator.ru/api/otp/?action=getPrices
Response: JSON: { "Country_ID": { "Service_Code": { "cost": "0.50", "count": 100 } } }
{
"1": {
"wa": { "cost": "0.50", "count": 100 },
"tg": { "cost": "0.71", "count": 250 }
}
}
2) getCountries
Purpose: list of supported countries.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | yes | getCountries |
Request:
https://sms-acktiwator.ru/api/otp/?action=getCountries
Response: JSON object keyed by Country ID:
{
"43": { "id": 43, "rus": "Германия", "eng": "Germany", "chn": "德国", "visible": 1 }
}
3) getServicesList
Purpose: list of supported services.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | yes | getServicesList |
Request:
https://sms-acktiwator.ru/api/otp/?action=getServicesList
Response:
{
"status": "success",
"services": [
{ "id": "1", "code": "wa", "name": "WhatsApp" },
{ "id": "2", "code": "tg", "name": "Telegram" }
]
}
4) getBalance (requires key)
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | yes | getBalance |
key | string | yes | Your API key |
https://sms-acktiwator.ru/api/otp/?action=getBalance&key=YOUR_API_KEY
Response (text/plain): ACCESS_BALANCE:12.50
Errors:
BAD_KEY— missing/invalid/disabled key.CHANNEL_LIMIT— rate limit exceeded (50/min per key).
5) getNumber (requires key)
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | yes | getNumber |
key | string | yes | Your API key |
country | string (number) | yes | Country ID (e.g. 43) |
service | string | yes | Service code (e.g. wa) |
https://sms-acktiwator.ru/api/otp/?action=getNumber&key=YOUR_API_KEY&country=43&service=wa
Response (text/plain): ACCESS_NUMBER:12345:380991234567
Errors:
BAD_KEY— missing/invalid/disabled key.BAD_COUNTRY— missing/invalid country value.BAD_SERVICE— missing/invalid service value.NO_BALANCE— insufficient user balance.NO_NUMBERS— no available numbers for the given parameters.CHANNEL_LIMIT— rate limit exceeded (50/min per key).UNKNOWN_ERROR— internal server error.
6) getStatus (requires key)
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | yes | getStatus |
key | string | yes | Your API key |
activationId | string (number) | yes | Activation ID from getNumber |
https://sms-acktiwator.ru/api/otp/?action=getStatus&key=YOUR_API_KEY&activationId=12345
Responses (text/plain):
STATUS_WAIT_CODE— SMS code not received yet.STATUS_OK:123456— code received.NO_ACTIVATION— activation not found / expired / closed.BAD_KEY— missing/invalid/disabled key.
Notes: After STATUS_OK:CODE you may finish the activation via setStatus with status=6.
7) setStatus (requires key)
https://sms-acktiwator.ru/api/otp/?action=setStatus&key=YOUR_API_KEY&activationId=12345&status=6
Status values: 3 resend, 6 complete, 8 cancel.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | yes | setStatus |
key | string | yes | Your API key |
activationId | string (number) | yes | Activation ID |
status | string (number) | yes | New status: 3, 6 or 8 |
Responses (text/plain):
ACCESS_ACTIVATION— activation completed.ACCESS_CANCEL— activation canceled.STATUS_WAIT_CODE— resend requested.NO_ACTIVATION— activation not found.BAD_KEY— missing/invalid/disabled key.BAD_STATUS— invalid status value or bad parameters.