GATUM — полнофункциональная платформа, которая может подключаться к клиентам с помощью различных подключений. После того, как новый клиент зарегистрировался на платформе или вы создали его в админ панели, то он может начать отправлять тестовые СМС. Клиент имеет возможность отправлять СМС из своей веб панели, а также через SMPP протокол или API (самый быстрый способ интеграции), или REST API (более профессиональный метод интеграции).
Сейчас мы расскажем, как настроить отправку через REST API. Мы используем сервис Postman для подключения. Перейдите по этой ссылке https://documenter.getpostman.com/view/3547620/SWEB1aY9.
Для авторизации в нашем REST API используется стандарт OAuth2.
Для этого, в сервисе Postman, после того, как вы перешли по ссылке выше, вам необходимо:
- На странице Autorization должен стоять верный адрес. После restapi введите свой домен, в этом случае — gatum.io.
- В блоке Body введите логин и пароль клиента от веб доступа в кабинет на платформе.
- Нажмите на синюю кнопку Send.
Система возвращает вам временный токен. Скопируйте его.
- Перейдите на страницу Access token.
- Проверьте верность адреса.
- В блоке Body вставьте временный токен, который вы скопировали ранее.
- Нажмите на синюю кнопку Send.
Система возвращает вам постоянный токен.
После получения постоянного токена вы можете использовать все API внизу (отправка одиночной СМС, массовая рассылка, создание базы данных номеров). Посмотреть пример использования этих API вы можете в видео на нашем YouTube канале.
Отчеты по отправленным СМС будут храниться на вкладке SMS full data. Используя фильтрацию вверху, вы можете узнать, какие именно SMS были отправлены по протоколу REST API.
Очередь отчетов по СМС отправленным через REST API вы можете отслеживать во вкладке RESTAPI DLRs.
Если у клиента будет несколько серверов, с которых он будет отправлять трафик по этому протоколу, то создайте для него соответствующее количество токенов и добавьте соответствующее количество IP адресов в блоке REST API IP. Это делается для того, чтобы отчеты о доставках не терялись (возможна ситуация что, если клиент подключиться с разных своих серверов, используя один и тот же логин, то СМС может прийти с одного сервера, а Отчет о доставке уйдет на другой сервер — ведь логин тот же самый). Поэтому рекомендуется контролировать этот момент.
Вот так легко вы можете настраивать подключение клиента по REST API протоколу.
