Документация API Activan

Наш сервис предоставляет простой и надежный API для работы с виртуальными номерами. Интерфейс полностью совместим со стандартными SMS-активационными сервисами.

Основная информация

Базовый URL для API-запросов:
http://activan.net/api/request

Поддерживаемые методы: GET, POST

Аутентификация: Все запросы должны содержать ваш уникальный API-ключ в параметре api_key

Получение API-ключа

API-ключ доступен в личном кабинете после регистрации на activan.net

Методы API

1. Проверка количества доступных номеров

GET/POST http://activan.net/api/request?api_key=$api_key&action=getNumbersStatus&country=$country

Параметры:

  • $api_key - ваш уникальный ключ доступа
  • $country - код страны (опционально)

Пример ответа:

{"wa":"44","vk":"32","tg":"400","ig":"2","ya":"100","tw":"999","mt":"32"}

Коды ошибок:

  • BAD_KEY - недействительный ключ API
  • BAD_ACTION - неверный тип запроса

2. Проверка баланса аккаунта

GET/POST http://activan.net/api/request?api_key=$api_key&action=getBalance

Параметры:

  • $api_key - ваш уникальный ключ доступа

Формат ответа:

ACCESS_BALANCE:100.50

3. Заказ виртуального номера (стандартный)

GET/POST http://activan.net/api/request?api_key=$api_key&action=getNumber&service=$service&country=$country&ref=$ref&operators=$operators&exceptOperators=$exceptOperators&maxPrice=$maxPrice

Параметры:

  • $api_key - ваш уникальный ключ доступа
  • $service - код сервиса (обязательно)
  • $country - код страны (опционально)
  • $operators - коды операторов через запятую, максимум 5 (опционально)
  • $exceptOperators - исключаемые операторы через запятую, максимум 5 (опционально)
  • $ref - реферальный ID для партнеров (опционально)
  • $maxPrice - максимальная цена покупки (опционально)

Формат ответа:

ACCESS_NUMBER:123456:79001234567

4. Заказ номера с расширенной информацией (getNumberV2)

GET/POST http://activan.net/api/request?api_key=$api_key&action=getNumberV2&service=$service&country=$country&ref=$ref&operators=$operators&exceptOperators=$exceptOperators&maxPrice=$maxPrice

Параметры:

Аналогичны методу getNumber

Формат ответа (JSON):

{
  "activationId": 123456,
  "phoneNumber": "79001234567",
  "activationCost": "5.50",
  "countryCode": "0",
  "activationTime": "2024-11-11 18:30:20"
}

Коды ошибок для обоих методов:

  • BAD_KEY - недействительный ключ API
  • BAD_ACTION - неверный тип запроса
  • BANNED - аккаунт временно заблокирован
  • BAD_SERVICE - неверный код сервиса
  • BAD_COUNTRY - некорректный код страны
  • BAD_MAX_PRICE - неверная максимальная цена
  • BAD_OPERATORS - оператор не найден
  • TOO_MANY_OPERATORS - превышено допустимое количество операторов (макс. 5)
  • BAD_EXCEPT_OPERATORS - исключаемый оператор не найден
  • TOO_MANY_EXCEPT_OPERATORS - превышено количество исключаемых операторов (макс. 5)
  • NO_BALANCE - недостаточный баланс
  • NO_CONNECTION - отсутствует подключение к сервису
  • NO_NUMBERS - нет доступных номеров для заказа

5. Проверка статуса активации

GET/POST http://activan.net/api/request?api_key=$api_key&action=getStatus&id=$id

Параметры:

  • $api_key - ваш уникальный ключ доступа
  • $id - идентификатор активации

Варианты ответа:

  • STATUS_OK:123456 - код получен
  • STATUS_WAIT_CODE - ожидание SMS
  • NO_ACTIVATION - активация не найдена

6. Управление статусом активации

GET/POST http://activan.net/api/request?api_key=$api_key&action=setStatus&status=$status&id=$id

Параметры:

  • $api_key - ваш уникальный ключ доступа
  • $id - идентификатор активации
  • $status - новый статус:
    • 1 - подтвердить готовность номера (SMS отправлена)
    • 3 - запросить повторную SMS (бесплатно)
    • 6 - завершить активацию успешно
    • 8 - отменить активацию

Варианты ответа:

  • ACCESS_READY - номер готов к получению кода
  • ACCESS_ACTIVATION - активация успешно завершена
  • ACCESS_CANCEL - активация отменена
  • NO_ACTIVATION - активация не найдена
  • BAD_STATUS - неверный статус
  • EARLY_CANCEL_DENIED - отмена невозможна в течение первых 2-х минут

7. Получение актуальных цен

GET/POST http://activan.net/api/request?api_key=$api_key&action=getPrices&priceMap=$priceMap

Параметры:

  • $api_key - ваш уникальный ключ доступа
  • $priceMap - формат ответа (true для детализированного JSON)

Формат ответа:

{"Код страны":{"Код сервиса":{"Цена":"Количество"}}}
{"2":{"wa":{"10.00":"10","15.00":"44"}}}

Коды ошибок:

  • BAD_KEY - недействительный ключ API
  • BAD_ACTION - неверный тип запроса

Алгоритм работы с API

Рекомендуемая последовательность действий:

📋 Этап 1: Получение номера

  1. Используйте метод getNumber или getNumberV2 для заказа номера
  2. Получите activationId и phoneNumber из ответа
  3. Сохраните данные для дальнейшей работы

⚡ Этап 2: Варианты действий

  • Статус 1: Уведомить о готовности (опционально)
  • Статус 8: Отменить активацию, если номер не подходит
  • Важно: Отмена недоступна в первые 120 секунд после получения номера

📨 Этап 3: Получение SMS-кода

  • Регулярно проверяйте статус методом getStatus
  • При получении STATUS_OK:код - SMS доставлена
  • При необходимости используйте статус 3 для запроса повторной SMS

✅ Этап 4: Завершение

  • Статус 6: Подтвердить успешное получение SMS и завершить активацию
  • Статус 3: Запросить дополнительную SMS (если первая не пришла)
  • Активация считается завершенной только после установки статуса 6

⚠️ Важные ограничения и правила

  • Номер нельзя отменить в течение первых 2 минут после получения
  • Максимальное время ожидания SMS составляет 20 минут
  • Повторный запрос SMS (статус 3) доступен бесплатно один раз
  • Неиспользованные номера автоматически отменяются через 20 минут
  • Рекомендуемый интервал проверки статуса - каждые 5-10 секунд

Техническая поддержка

При возникновении вопросов обращайтесь через форму обратной связи или по email поддержки.

Связаться с поддержкой