Документация REST API сервиса BSG
Интегрируйте возможности сервиса рассылок BSG в личный проект.
API предназначен для разработчиков и сопровождается детальной документацией.
SMPP Введение
SMPP — (Short Message Peer-to-Peer) короткие сообщения одноранговой сети. Является открытым стандартом в телекоммуникационной отрасли, который разработан специально, чтобы обеспечить гибкий интерфейс для передачи коротких сообщений между внешними сущностями (устройства, приложения) коротких сообщений (ESME), маршрутизаторами и центров сообщений (SMSC).
Сервер SMPP
Привязки и пропускная способность
Всякий раз, настраивая учетную запись SMPP, вы получите максимальное количество привязок, которое разрешено установить. В большинстве случаев это 3 привязки, с пропускной способностью 50 сообщений в секунду. Сервер BSG SMPP поддерживает только одно подключение через трансивер (TRX) или несколько соединений через передатчик (TX) с одним подключенным приемником (RX).
Имя пользователя и пароль
Процесс авторизации возможен при наличии персонального ключа, сгенерировать который вы можете самостоятельно в настройках или обратившись к менеджеру вашего аккаунта BSG.
Безопасность
Для соединения SMPP BSG требует внести в white list ваш исходный IP-адрес. Чтобы получить доступ, отправьте свое имя пользователя и исходный IP-адрес в нашу службу поддержки support@bsg.hk.
Поддерживаемые PDUs
Сервер BSG поддержиет следующие PDU файлы:
0x00000001
0x80000001
0x00000002
0x80000002
0x00000009
0x80000009
0x00000005
0x80000005
0x00000015
0x80000015
0x00000004
0x80000004
0x00000006
0x80000006
Bind PDU
SMPP bind_receiver, bind_transceiver или bind_transmitter PDU имеет фиксированный набор полей. Большинство полей не имеют к нам никакого отношения. Мы читаем только system_id, password, system_type and interface_version поля. Остальное игнорируется.
The username
SMPP-password
IGNORED if you want to use default tariff or set tariff-x, where x is the code of tariff name
The SMPP protocol version you want to talk
IGNORED
IGNORED
IGNORED
Interface_Version
BSG SMPP сервер поддерживает SMPP протокол версии 3.4 and 5.0. Обратите внимение, что в SMPP 5.0. команда SUBMIT_SM_RESP содержит статус кода ошибки, длина PDU составляет 16 oктет.
Data_Coding
The values for the data_coding field are not solidly declared in the SMPP spec, so each SMPP server is more or less required to give its own definition.
Default Alphabet (GSM 3.38), 7-bit characters
IA5/ASCII, 7-bit characters
ISO-8859-1 (LATIN1), 8-bit characters
Japanese (JIS), multi-byte characters
Cyrillic (ISO-8859-5), 8-bit characters
Latin/Hebrew (ISO-8859-8), 8-bit characters
Unicode (USC-2), 16-bit characters
Korean (KS C 5601), multi-byte characters
Для 7-битных наборов символов в одно SMS-сообщение может поместиться максимум 160 символов; для 8-битных наборов символов ограничение составляет 140 символов; для 16-битных наборов символов ограничение составляет 70 символов; для многобайтовых наборов символов ограничение составляет от 70 до 140 символов, в зависимости от того, из каких символов был составлен текст сообщения. (Для многобайтовых наборов символов большинство символов имеют размер 16 бит; некоторые из наиболее распространенных символов состоят из восьми бит.)