SMS API в GSM-шлюзах Dinstar

SMS API або HTTP API - це рішення для прийому та відправки SMS повідомлень через IP-GSM-шлюзи Dinstar в різних програмах за допомогою HTTP-запитів.
За допомогою API можна налаштувати різні інтеграції і вирішувати різні завдання. Наприклад, API дозволяє приймати та відправляти СМС повідомлення, USSD-запити та здійснювати групове розсилання СМС. Також через запити API можна отримувати інформацію про статус портів IP-GSM-шлюзу, отримувати статистику дзвінків CDR, встановлювати правила переадресації для сім-карток.

Використовувати API можна з усіма моделями IP-GSM-шлюзів Dinstar від 2 до 32 сім-карток - UC2000-VE, UC2000-VF, UC2000-VG, як з бізнес-версією, так і з повною версією.

Dinstar HTTP API надає безліч можливостей для керування GSM-шлюзами. Нижче наведено основні можливості API, які доступні у всіх моделях шлюзів.

Основні можливості Dinstar HTTP API:

• Надсилання СМС — надсилання повідомлень на мобільні номери, у тому числі й групове розсилання СМС
• Отримання статусу відправки SMS — перевірка успішності доставки повідомлень.
• Прийом вхідних СМС — шлюз може отримувати вхідні повідомлення та надсилати їх через API у вашу програму.
• USSD-запити — надсилання команд для перевірки балансу, активації послуг та інших операцій.
• Запит інформації про SIM-картки – рівень сигналу, статус мережі, стан порту.
• CDR API — доступ до даних про дзвінки та SMS для аналізу.
• STK API – керування SIM-картами через API, так званий SIM Toolkit
• Запит стану портів — Перевірте, які SIM-картки активні та працюють.
• Перевірка черги SMS — отримання інформації про повідомлення, які очікують надсилання.

Основні переваги HTTP API Dinstar:

• Простота інтеграції - API заснований на HTTP та JSON, що спрощує взаємодію з сервером та шлюзами
• Гнучкість — підтримує відправлення та отримання SMS, USSD-запити, керування сім-картами та моніторинг стану шлюзу
• Масштабованість — дозволяє працювати з великою кількістю шлюзів та SIM-карток одночасно.
• Автоматизація — можна настроїти масове відправлення SMS, перевірку балансу та керування портами без ручного втручання.
• Моніторинг та аналітика — API надає дані про статус сім-карток, рівень сигналу, черги повідомлень та дзвінків.
• Безпека – підтримує авторизацію та контроль доступу до шлюзу

Як працює Dinstar HTTP API.

HTTP API - це набір HTTP запитів з різними параметрами, які потрібно надсилати з вашої програми, наприклад CRM чи CMS систем.

Для роботи API окремий сервер не потрібний. Потрібна лише програма, яка надсилатиме http-запити до GSM-шлюзу.
Наприклад, це може бути скрипт зручною для вас мовою програмування (Python, C#, PHP, Node.js, C/C++).

API базується на HTTP та JSON. Тому для роботи вам потрібно знати, як надсилати HTTP-запити та як кодувати/декодувати дані JSON.

На шлюзі API вмикається через веб-інтерфейс керування.

Як надіслати SMS через API?

Ось приклад запиту на надсилання повідомлення:
http:/GATE_IP_ADDRESS:PORT/cgi-bin/sms_send?username=login&password=password&phonenumber=0232323231&message=Текст_сообщения
Після надсилання API поверне результат відправки - успішно або помилка.

Якщо вас цікавить групове розсилання СМС, потрібно мати на увазі таку інформацію.
Відправка одного SMS займає від 5 до 8 секунд, якщо ж якість мобільного сигналу не дуже висока, то цей час може збільшитися в кілька разів.
Таким чином, через одну сім-карту можна відправити до 10 SMS за 1 хвилину.

У нових версіях прошивки GSM-шлюз може надсилати деякі події, такі як вхідні SMS, результати відправки SMS, статус доставки SMS, пропущені дзвінки, на адресу HTTP, наприклад, на ваш веб-сервер.
Після того, як ви увімкнете відправлення PUSH-повідомлень, усі SMS-повідомлення, отримані шлюзом, будуть надіслані на ваш веб-сервер.
Так ви зможете приймати вхідні SMS без використання API.

Практичне застосування Dinstar HTTP API.

Ось кілька прикладів використання HTTP API у реальних проектах:

• Автоматизована відправка СМС повідомлень клієнтам із CRM-систем або CMS-систем Наприклад, інтернет-магазини можуть надсилати підтвердження замовлень, а логістичні компанії – статуси доставки.
• Системи моніторингу та оповіщення API дозволяє налаштувати автоматичні оповіщення про збої в роботі обладнання чи інші події.
• Наприклад, можна надсилати SMS-повідомлення адміністраторам при критичних помилках у роботі обладнання.
• Банки та фінансові компанії - банки можуть використовувати API для надсилання клієнтам одноразових паролів (OTP) та повідомлень про транзакції.
• IoT та інші "розумні" системи – у таких проектах API допомагає пристроям обмінюватися даними через SMS, наприклад, для віддаленого керування обладнанням.