Loading…

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 — запросить ещё одно SMS
  • 6 — завершить активацию
  • 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:

ParameterTypeRequiredDescription
actionstringyesgetPrices

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:

ParameterTypeRequiredDescription
actionstringyesgetCountries

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:

ParameterTypeRequiredDescription
actionstringyesgetServicesList

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:

ParameterTypeRequiredDescription
actionstringyesgetBalance
keystringyesYour 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:

ParameterTypeRequiredDescription
actionstringyesgetNumber
keystringyesYour API key
countrystring (number)yesCountry ID (e.g. 43)
servicestringyesService 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:

ParameterTypeRequiredDescription
actionstringyesgetStatus
keystringyesYour API key
activationIdstring (number)yesActivation 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:

ParameterTypeRequiredDescription
actionstringyessetStatus
keystringyesYour API key
activationIdstring (number)yesActivation ID
statusstring (number)yesNew 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.