ru

Опис роботи зі шлюзом TurboSMS за допомогою SQL підключення до бази даних

Наша база даних працює під управлінням СУРБД MySQL 5. Для того щоб мати можливість підключатися безпосередньо до нашої БД, Ви повинні в розділі налаштувань шлюзу поставити пташку "SQL" в полі «Способи підключення». Після цього буде створений Власний кабінет з логіном та паролем, які Ви вказали для підключення до шлюзу, а також таблиця для зберігання Ваших даних в БД «users».

Після всього цього можна підключатися до БД і працювати з нею. Підключайтесь до БД будь-яким доступним Вам способом. Сервер БД знаходиться за адресою sql.turbosms.ua, робоча база даних - «users», ім'я Вашої таблиці таке ж, як і логін підключення до шлюзу 1.

Створений Власний кабінет має обмежений доступ. Ви можете записувати значення ТІЛЬКИ в конкретні поля, а також можете видаляти записи. Змінювати значення полів або структури таблиці Ви не можете. Перевірка на наявність нових записів проводиться кожну секунду. Всі оброблені записи стають доступними для перегляду в web інтерфейсі TurboSMS.

Кодування таблиці - utf8, тому кириличний текст повідомлень повинен бути в кодуванні UTF-8. Щоб коректно вставляти російськомовний текст і читати тексти статусів відправлення після підключення до серверу, виконуйте запит SET NAMES utf8;. Для використання нашої БД в інших СУРБД встановіть драйвер MySQL ODBC 5.1, або MySQL ODBC 3.ХХ. При використанні драйвера версії 5.1 можуть виникнути проблеми з правами, тому рекомендуємо використовувати версію 3.XX

За замовчуванням, при підключенні діє часовий пояс України (UTC+2, UTC+3 в літній час). Для зміщення тимчасової зони використовується запит виду SET timezone = '+00:00';, де +00:00 — зміщення тимчасової зони.

Для стабільної роботи сервісу та швидкого виконання запитів пошуку даних в таблицях, ми видаляємо записи, які були додані більш ніж 180 днів (пів року) тому. Також, якщо за цей період по налаштованому підключенню не було додано жодного запису, то ми видаляємо і його. Створити нове підключення ви можете в будь-який момент в своєму кабінеті користувача.

Всі повідомлення відразу ж після додавання потрапляють в базу даних TurboSMS, подальші зміни вмісту sms НЕ синхронізуються. Якщо Вам потрібно щось змінити у прийнятих до опрацювання повідомленнях, необхідно спочатку видалити їх, а потім додати ще раз з оновленими даними.


Структура таблиці користувача

Поле Тип Доступ Призначення
id integer Читання Автоінкрементне поле зберігає ID повідомлення для швидкого пошуку
msg_id 2 string (36) Читання ID повідомлення в системі. За даним ID Ви можете дізнаватися статус доставки
number string (21) Повний Номер отримувача, який задається у міжнародному форматі, тільки цифри
sign string (11) Повний Альфаім’я (підпис відправника)
message string (1530) Повний Текст повідомлення
wappush 3 string (128) Повний Посилання WapPush, включно з http://
is_flash 3 bool Повний Флаг flash повідомлення (1 - так, 0 - ні)
cost 2 decimal(4,2) Читання Вартість повідомлення у гривні
balance 2 decimal(10,2) Читання Залишок грошей на балансі користувача після обробки
added 2 timestamp 4 Читання Дата і час додавання запису у таблицю
send_time timestamp 4 Повний Дата і час запланованої відправки повідомлення
sended 2 timestamp 4 Читання Дата і час фактичної відправки повідомлення
received 2 timestamp 4 Читання Дата і час поновлення статусу
error_code 2 string (3) Читання Код помилки при обробці
status 2 string Читання Статус доставки за специфікацією протоколу SMPP v3.4

1 Зверніть увагу, при зміні логіна підключення до шлюзу змінюється Власний кабінет і назва Вашої таблиці, тому будьте уважні

2 Дані полів заповнюються нашим сервером при обробці повідомлення. Якщо у значеннях полів вказано NULL, отже, обробка ще не проводилася

3 Деякі моделі телефонів не підтримують wappush і flash повідомлення

4 Формат дати для всіх полів дати і часу: ГГГГ-ММ-ДД ЧЧ:ММ, враховується встановлений часовий пояс з'єднання


Опис значень поля status

status Опис
NULL Повідомлення, що не оброблено
ACCEPTD Повідомлення прийнято до опрацювання
ENROUTE Повідомлення надіслано до мобільної мережі
DELIVRD Повідомлення доставлено отримувачу
EXPIRED Закінчився термін повідомлення
DELETED Видалено оператором
UNDELIV Не доставлено
REJECTD Повідомлення відхилено
UNKNOWN Невідомий статус

Опис значень поля error_code

error_code Опис
0 Помилок немає
2 Не вдалося зберегти дані, зв'яжіться з відділом підтримки, якщо помилка буде повторюватися
23 Помилки у номері отримувача
34 Країна отримувача не підтримується, необхідна додаткова активація
36 Не вдалося відправити повідомлення, зв'яжіться з відділом підтримки, якщо помилка буде повторюватися
40 Недостатньо коштів на балансі
46 Номер отримувача у стоплисті
69 Альфаім’я (підпис відправника) заборонено адміністратором
83 Дублікат повідомлення
84 Відсутній текст повідомлення
85 Неправильне альфаім’я (підпис відправника)
86 Текст повідомлення містить заборонені слова
87 Занадто довгий текст повідомлення
88 Ваш профіль заблокований за порушення, зв'яжіться з відділом підтримки
999 Специфічна помилка конкретного оператора, необхідно уточнювати додатково

У цьому переліку наведені найчастіші коди помилок. Якщо якогось коду немає в списку, будь ласка, зв'яжіться з відділом підтримки.

Ошибка