Описание работы со шлюзом TurboSMS
с помощью SQL подключения к базе данных
Наша база данных работает под управлением СУРБД MySQL 5. Для того, чтобы иметь возможность подключаться напрямую к нашей БД, Вы должны в разделе настроек шлюза поставить галочку "SQL" в поле «Способы подключения». После этого будет создана учётная запись с логином и паролем, которые Вы указали для подключения к шлюзу, а также таблица для хранения Ваших данных в БД «users».
После всего этого можно подключаться к БД и работать с ней. Подключаетесь к БД любым доступным Вам способом. Сервер БД находится по адресу 77.120.116.10, рабочая база данных «users», имя Вашей таблицы такое же, как и логин подключения к шлюзу 1.
Созданная учётная запись имеет ограниченый доступ. Вы можете записывать значения ТОЛЬКО в конкретные поля, а также можете удалять записи. Изменять значения полей или структуры таблицы Вы не можете. Обработка добавленных записей происходит каждую минуту.
Кодировка таблицы - utf8, поэтому кириллический текст сообщений должен быть в кодировке UTF-8. Чтобы корректно вставлять русскоязычный текст и читать тексты статусов отправки, после подключения к серверу выполняйте запрос SET NAMES utf8;. Для использования нашей БД в других СУРБД, установите драйвер MySQL ODBC 5.1, или MySQL ODBC 3.ХХ при использовании в СУРБД Oracle.
Также можете воспользоваться нашим phpMyAdmin для работы к базой данных.
Структура таблицы пользователя
| Поле |
Тип |
Можно писать |
Назначение |
| id |
integer |
Нет |
Автоинкрементное поле, хранит ID сообщения для быстрого поиска |
| msg_id 2 |
string (36) |
Нет |
ID сообщения в системе. По данному ID Вы можете узнавать статус доставки любым способом подключения, поддерживаемым нашим шлюзом |
| number |
string (13) |
Да |
Номер получателя, задаётся в международном формате |
| sign |
string (13) |
Да |
Подпись или номер отправителя |
| message |
string |
Да |
Текст сообщения |
| wappush |
string (128) |
Да |
Ссылка WAPPush, включая http:// |
| cost 2 |
integer |
Нет |
Стоимость сообщения в кредитах системы |
| credits 2 |
integer |
Нет |
Остаток кредитов на счету пользователя |
| send_time |
datetime 3 |
Да |
Дата и время запланированной отправки сообщения |
| sended 2 |
datetime 3 |
Нет |
Дата и время фактической отправки сообщения |
| updated |
datetime 3 |
Нет |
Дата и время последнего обновления данных сообщения |
| status 2 |
string (256) |
Нет |
Текстовое описание результата отправки |
| dlr_status 2 |
string |
Нет |
Статус доставки из спецификации прокола SMPP v3.4 + несколько наших значений |
1 Обратите внимание, при смене логина подключения к шлюзу, меняется учётная запись и название Вашей таблицы, поэтому будьте внимательны
2 Данные полей заполняются нашим сервером после отправки сообщения. Если значения полей пустые, значит отправка ещё не производилась
3 Формат даты для всех полей даты и времени: ГГГГ-ММ-ДД ЧЧ:ММ
Описание значений полей status и dlr_status
| status |
dlr_status |
Описание |
| |
UNSENDED |
Сообщение ещё не отправлено |
| Ошибка, сообщение не отправлено |
ERROR |
Отправка сообщения закончилась неудачей, свяжитесь с техническим отделом для большей информации |
| Не достаточно кредитов на счете |
ERROR |
Сообщение не отправлено, пополните свой внутренний счёт |
| Отправлено |
SENDED |
У сообщения ещё не обновлялся статус доставки |
| Сообщение передано в мобильную сеть |
ENROUTE |
Сообщение доставлено на сервер оператора |
| Сообщение доставлено получателю |
DELIVRD |
|
| Истек срок сообщения |
EXPIRED |
Статус доставки не был получен некоторое время, сообщение потерялось |
| Удалено оператором |
DELETED |
Сообщение нарушает какие-то правила оператора |
| Не доставлено |
UNDELIV |
|
| Сообщение доставлено на сервер |
ACCEPTD |
Сообщение на сервере отправки |
| Отклонено оператором |
REJECTD |
Сообщение нарушает какие-то правила оператора или невозможно доставить смс абоненту |
| Неизвестный статус |
UNKNOWN |
Свяжитесь с техническим отделом для большей информации |
| Отправка отменена |
RECREDITED |
Отправка сообщения была отозвана пользователем или администратором |
| Отправка приостановлена |
STOPPED |
Отправка сообщения была прервана пользователем или администратором |
| Удалено пользователем |
REMOVED |
Пользователь или администратор удалил данное сообщение |