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

SMS API или HTTP API - это решение для приема и отправки СМС сообщений через 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:

• Отправка СМС — отправка сообщений на мобильные номера, в том числе и групповая рассылка СМС
• Получение статуса отправки СМС — проверка успешности доставки сообщений.
• Прием входящих СМС — шлюз может получать входящие сообщения и передавать их через 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 вернет статус успешности или ошибки.

Если вас интересует групповая рассылка СМС, нужно иметь в виду следующую информацию.
Отправка одного СМС занимает от 5 до 8 секунд, если же качество мобильного сигнала не очень высокое, то это время может увеличиться в несколько раз.
Таким образом, через одну сим-карту можно отправить около 10 СМС за 1 минуту.

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

Практическое применение Dinstar HTTP API.

Вот несколько примеров использования HTTP API в реальных проектах:

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