Платформа GATUM предлагает своим пользователям два вида API:
- HTTP API — для быстрой интеграции;
- REST API — для профессионально интеграции.
Чтобы понять, какую интеграцию необходимо использовать, нужно отбросить свои знания программировании и просто выбрать, что Вам удобнее.
Если, к примеру, Вам необходимо отправлять одиночные СМС, с какой то информацией (проверочные коды или ссылки) — то Вам достаточно будет сделать интеграцию с HTTP API. Для этого, в кабинете пользователя, просто сгенерируйте токен и Вы уже готовы отправлять СМС через API. Этот токен будет с Вами, пока Вы его самостоятельно не удалите. И даже если измените пароль в Кабинет пользователя, то токен останется таким же. Чтобы все заработало — то Вам необходимо в Ваш программный продукт или платформу добавить правильную структуру URL, как в примере в кабинете (конечно с нужным номером, Именем отправителя и текстом). На все про все может уйти 15 минут, из которых 10 минут уйдет на заваривание кофе.
Если же Вы решили использовать REST API, то, во-первых, необходимо овладеть алгоритмом авторизации OAuth2. Ибо для того чтобы получить токен для REST API, необходимо, используя логин и пароль для входа в кабинет — сгенерировать этот токен, пройдя необходимые этапы, согласно требованиям OAuth2. То есть, если вы смените пароль, то не забудьте сообщить об этом маневре скрипту, которые отправляет СМС с вашей платформы. Кстати, этот токен можно использовать, не только для одной смс/запроса, а и для всех последующих, пока токен не самоликвидируется по сроку жизни. Когда вы смогли завладеть токеном — то Вам открыты все дороги, для Вас есть API — для отправки СМС (одиночных и массовых). А бонусом у Вас появляется возможность эмулировать работу человека в кабинете пользователя. Вы теперь сможете:
- создавать Базу номеров клиентов;
- заливать в нее список номеров;
- создавать рассылку по этой базе;
- проверять информацию об отправленных СМС;
- и так далее.
Если у Вас будет достаточное количество ресурсов, вы можете у себя в платформе создать аналогичные формы, как у нас в Кабинете пользователя — и дать возможность своим клиентам делать рассылки используя Вашу платформу или программное обеспечение.
Обе версии API работают по зашифрованному протоколу — HTTPS, поэтому о скрытности данных заботится уже сам протокол передачи данных от Вас к нам.
Исходя из вышеописанного, то наши рекомендации по выбору API следующие:
Выбрав HTTP API вы получаете:
- быструю интеграцию;
- токен, который не зависит от изменении пароля;
- возможность отправлять одиночные СМС.
Выбрав REST API вы получаете:
- расширенный функционал для работы с нашей платформой;
- немного усложняется процесс авторизации (и существует зависимость от пароля в кабинет);
- возможность отправлять и одиночные и массовые СМС;
Отчеты о доставке (если, конечно, они Вам нужны), мы будем отправлять на Ваш webhook самостоятельно, Вам необходимо просто реализовать свой webhook, чтобы ловить отчеты.
ВАЖНО: Используя нашу платформу, необходимо понимать, что каждый запрос должен идти после получения ответа от предыдущего, ибо наша платформа может Вас заблокировать, так как может посчитать, что происходит несанкционированная атака, а в случае атаки — мы беспощадны.
Поэтому, если Ваша платформа или программное обеспечение НЕ поддерживает отправку на уровне SMPP протокола, то Вы можете выбрать более просто способ отправки — а это API.
Реализовав интеграцию один раз — Вы освобождаете свое время для более интересных задач!
Если у вас остались вопросы, свяжитесь с нами victoria.prisyazhnyuk@sempico.solutions.
