API Grizzly SMS

API — это протокол взаимодействия вашего ПО с нашим сервером активаций.
API нужен для автоматизации получения SMS на вашей стороне
Наш API совместим с API sms-activate

Во всех запросах должен быть API-ключ в параметре api_key

API активаций
API-утилиты
Таблицы
API партнёра
  • Описание работы протокола
  • Метод запроса количества номеров GET_SERVICES
  • Метод запроса GET_NUMBER
  • Доставка SMS на сервер Grizzly SMS с помощью метода PUSH_SMS
  • Метод запроса завершения активации FINISH_ACTIVATION
  • Метод запроса передачи записи звонка PUSH_CALL_RECORD
  • Метод запроса передачи информации о звонке PUSH_CALL
  • Таблица статусов
  • Тестирование протокола
  • Таблица данных
  • API для изменения цен
  • Условия и компенсации
  • OpenAPI
Описание работы протокола

Партнёрский протокол предназначен для предоставления телефонных номеров и входящих SMS‑сообщений через API напрямую на сервер Grizzly SMS.

Все запросы содержат параметр KEY. Этот ключ выдаётся сотрудниками поддержки и доступен в личном кабинете.

Запросы количества GET_SERVICES, запросы номеров GET_NUMBER и запросы завершения активации FINISH_ACTIVATION отправляются напрямую с нашего сервера на сервер партнёра.

Формат URL: https://GrizzlySMS, где GrizzlySMS может быть partner.ru:port/GrizzlySMS.php или partner.ru/GrizzlySMS.php

  • GET_SERVICES
  • GET_NUMBER
  • PUSH_SMS
  • FINISH_ACTIVATION
  • Сервер Grizzly SMS отправляет запрос на количество телефонных номеров методом GET_SERVICES примерно каждые 10–20 секунд.
  • Если в ответе вы указываете количество > 0, вы получаете запрос на выдачу телефонного номера методом GET_NUMBER.
  • После получения запроса GET_NUMBER вы обязаны предоставить номер, удовлетворяющий всем критериям, и пересылать все входящие SMS‑сообщения нам методом PUSH_SMS. Это необходимо для того, чтобы мы могли выполнять прозрачную и объективную фильтрацию и доставлять релевантные SMS нужному сервису для наших клиентов.
  • После завершения всех необходимых действий, связанных с телефонным номером, вы получаете статус 3 через метод FINISH_ACTIVATION. Этот статус означает, что номер был успешно использован для регистрации, и вы получили за него вознаграждение.

Требования:

  • Формат запросов/ответов: JSON
  • Кодировка UTF‑8
  • Во всех запросах к серверу Grizzly SMS необходимо указывать заголовок user-agent

Типы полей:

  • int: целое число в диапазоне от -2 147 483 648 до 2 147 483 647
  • Uint: целое неотрицательное число в диапазоне от 0 до 2 147 483 647
  • long: целое число в диапазоне от -9 223 372 036 854 775 808 до 9 223 372 036 854 775 807
  • Ulong: целое неотрицательное число в диапазоне от 0 до 9 223 372 036 854 775 807
  • cur: вещественное число с точностью до 2 знаков после запятой, например 177.77
  • boolean: логические литералы true или false
  • string: строковое значение неограниченной длины
  • array of string: массив строк