SMS API, SMPP API MS Scheduler API
Посібник користувача
SMS API, SMPP API MS Scheduler API
| Змінено: | 6 |
| Версія: | 1.7 |
| Автор: | Кенні Коландер Норден, KCN |
Цей документ призначений лише для вказаного одержувача та може містити конфіденційну, конфіденційну чи іншу конфіденційну інформацію. Якщо ви отримали його помилково, негайно повідомте відправника та видаліть оригінал. Будь-яке інше використання вами документа заборонено.
Історія змін
| Рев | Дата | By | Зміни порівняно з попереднім випуском |
| 1.0 | 2010-03-16 | KCN | Створено |
| 1. | 2019-06-11 | TPE | Оновлені логотипи LINK |
| 1. | 2019-09-27 | PNI | Додано посилання на специфікацію SMPP 3.4 |
| 1. | 2019-10-31 | EP | Спостереження про термін дії tag |
| 1. | 2020-08-28 | KCN | Додано інформацію про підтримувані версії TLS |
| 2. | 2022-01-10 | KCN | Додано додаткову інформацію щодо звітів про доставку Оновлена інформація щодо TLS 1.3 |
| 2. | 2025-06-03 | GM | Додано код результату 2108 |
| 2. | 2025-06-24 | AK | Додана квота |
вступ
LINK Mobility є дистриб'ютором SMS з 2001 року і має великий досвід роботи як з операторами, так і з агрегаторами зв'язку. Ця платформа призначена для обробки великих обсягів трафіку, підтримки високої доступності та полегшення маршрутизації трафіку через кілька з’єднань.
У цьому документі описано інтерфейс SMPP до платформи SMSC, а також необхідні параметри та команди, а також підтримувані параметри.
У цьому документі не розглядаються конкретні випадки використання, такі як об’єднані повідомлення, WAPpush, Flash SMS тощо. Більше інформації про ці випадки можна отримати, звернувшись до служби підтримки.
Підтримувані команди
Сервер LINK Mobility слід розглядати як SMPP 3.4. Офіційну специфікацію можна знайти за адресою https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Усі методи не підтримуються, і всі відмінності вказані нижче.
4.1 Зв'язати
Підтримуються наступні команди зв’язування.
- Передавач
- Трансивер
- Приймач
Необхідні параметри:
- system_id – отримано від служби підтримки
- пароль – отримати в техпідтримці
Додаткові параметри:
- addr_ton – значення за замовчуванням, якщо TON встановлено на Unknown під час надсилання.
- addr_npi – значення за замовчуванням, якщо NPI встановлено на Невідомий під час надсилання.
Непідтримувані параметри:
- діапазон_адрес
4.2 Розв’язати
Підтримується команда unbind.
4.3 Посилання запиту
Команда запиту посилання підтримується, її слід викликати кожні 60 секунд.
4.4 Надіслати
Для доставки повідомлень слід використовувати метод submit.
Необхідні параметри:
- джерельна_адреса
- джерело_addr_npi
- джерело_адреса
- dest_addr_ton
- dest_addr_npi
- адреса_призначення
- esm_class
- кодування даних
- см_довжина
- коротке_повідомлення
Непідтримувані параметри:
- тип_послуги
- protocol_id
- прапор_пріоритету
- розклад_час_доставки
- replace_if_present_flag
- sm_default_msg_id
Примітка що корисне навантаження tag не підтримується, і лише одне SMS може бути доставлено на дзвінок, і рекомендується, щоб validity_period tag має значення принаймні 15 хвилин.
4.4.1 Рекомендовані TON і NPI
Під час надсилання повідомлень за допомогою команди submit слід використовувати такі TON і NPI.
4.4.1.1 Джерело
Для адреси джерела підтримуються такі комбінації TON та NPI. Усі інші комбінації вважатимуться недійсними. Якщо для TON встановлено значення Невідомо (0), буде використано команду TON from bind за замовчуванням. Якщо для NPI встановлено значення Невідомо (0), буде використано команду NPI from bind за замовчуванням.
| ТОННА | НПІ | опис |
| Буквено-цифровий (5) | Невідомий (0) ISDN (1) |
Буде розглядатися як буквено-цифровий текст відправника |
| міжнародний (1) | Невідомий (0) ISDN (1) |
Буде розглядатися як MSISDN |
| Національний (2) Специфічний для мережі (3) Номер абонента (4) Скорочено (6) |
Невідомий (0) ISDN (1) Національний (8) |
Буде розглядатись як короткий номер країни. |
4.4.1.2 Пункт призначення
Наступні комбінації TON і NPI підтримуються для адреси призначення. Усі інші комбінації будуть вважатися недійсними. Якщо для TON встановлено значення Невідомо (0), використовуватиметься стандартна команда TON із зв’язування. Якщо для NPI встановлено значення Unknown (0), використовуватиметься стандартний NPI з команди bind.
| ТОННА | НПІ | опис |
| міжнародний (1) | Невідомий (0) ISDN (1) |
Буде розглядатися як MSISDN |
4.4.2 Підтримувані кодування
Підтримуються наступні кодування. X може містити будь-яке значення.
| DCS | Кодування |
| 0xX0 | Стандартний алфавіт GSM із розширенням |
| 0xX2 | 8-розрядний двійковий файл |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Квота
5.1 Перевищення квотиview
Квота визначає максимальну кількість SMS-повідомлень, які можна надіслати протягом певного інтервалу часу (наприклад, за день, тиждень, місяць або необмежений час). Кожна квота унікально ідентифікується за допомогою quotaId (UUID) і скидається відповідно до часового поясу клієнта. Квоти можна призначати на рівні країни, регіону або за замовчуванням за допомогою Quota Pro.fileКвоту також можна динамічно призначати за допомогою зіставлення квот. Це зіставляє батьківський QuotaId (UUID) та унікальний ключ квоти (наприклад, відправника або користувача) з певним quotaId.
Квота встановлюється відповідно до вашої місцевої служби підтримки, призначеного вам менеджера облікового запису або за замовчуванням, якщо нічого не вказано.
5.2 Статус 106 – Квота перевищена
SMS-повідомлення може бути заблоковано з кодом стану 106 («квота перевищена»), якщо:
- Повідомлення перевищує визначений ліміт для відповідного квотаId у поточному інтервалі.
- Країна або регіон призначення не мають призначеної квоти (тобто явно заблоковані з нульовим відображенням квоти в програміfile).
- Немає відповідної квоти та не визначено квоту за замовчуванням, що призводить до відхилення.
У цих випадках система запобігає подальшій обробці повідомлень, щоб забезпечити дотримання обмежень, пов'язаних з клієнтом або пунктом призначення, та уникнути зловживань.
Звіт про доставку
Підтримується лише відсутність або остаточна доставка з успішним/невдалим результатом.
Формат звіту про доставку: ідентифікатор: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Дата виконання: ррММДдГГмм статистика:
Доступні значення в статусі:
- DELIVRD
- ПРОСТРАНЕНИЙ
- REJECTD
- НЕВИДАТИ
- ВИДАЛЕНО
6.1 Формат розширеного звіту про доставку
Розширену інформацію у звітах про доставку можна запитати, звернувшись до свого торгового представника.
Формат звіту про доставку: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 дата надсилання:
ррММддГГхмм дата виконання: ррММддГГхмм статистика: помилка: текст:
Доступні значення в статусі:
- DELIVRD
- ПРОСТРАНЕНИЙ
- REJECTD
- НЕВИДАТИ
- ВИДАЛЕНО
Поля «sub» і «dlvrd» завжди будуть мати значення 000, а поле «text» завжди буде порожнім.
Значення поля «err» див. у розділі «Коди помилок».
Підтримувані версії TLS
TLS 1.2 або TLS 1.3 потрібен для всіх з’єднань TLS через SMPP.
Підтримка TLS 1.0 і 1.1 припинена з 2020 листопада 11 року. Версії 15 і 1.0 TLS – це старіші протоколи, які застаріли та вважаються загрозами безпеці в Інтернет-спільноті.
LINK настійно рекомендує використовувати TLS, якщо сьогодні використовуються незашифровані з’єднання SMPP. Незашифровані з’єднання SMPP застаріли з 2020 за LINK, і їх буде видалено в майбутньому. Дата видалення незашифрованих з’єднань ще не визначена.
Підключення до сервера SMPP для TLS здійснюється через порт 3601 замість незашифрованого порту 3600.
Ви все ще можете використовувати TLS, навіть якщо ваша реалізація SMPP не підтримує TLS за допомогою stunnel, див https://www.stunnel.org/
Коди помилок
Наступні коди помилок можуть бути заповнені в полі err, якщо це поле ввімкнено.
| Код помилки | опис |
| 0 | Невідома помилка |
| 1 | Тимчасова помилка маршрутизації |
| 2 | Постійна помилка маршрутизації |
| 3 | Перевищено максимальне обмеження |
| 4 | Час очікування |
| 5 | Невідома помилка оператора |
| 6 | Помилка оператора |
| 100 | Сервіс не знайдено |
| 101 | Користувача не знайдено |
| 102 | Обліковий запис не знайдено |
| 103 | Недійсний пароль |
| 104 | Помилка конфігурації |
| 105 | Внутрішня помилка |
| 106 | Квота перевищена |
| 200 | OK |
| 1000 | Надіслано |
| 1001 | Доставлено |
| 1002 | Термін дії минув |
| 1003 | Видалено |
| 1004 | Мобільний повний |
| 1005 | У черзі |
| 1006 | Не доставлено |
| 1007 | Доставлено, плату відкладено |
| 1008 | Стягнуто, повідомлення не відправлено |
| 1009 | Стягнено, повідомлення не доставлено |
| 1010 | Термін дії закінчився, відсутність звіту про доставку оператора |
| 1011 | Оплачено, повідомлення відправлено (оператору) |
| 1012 | Дистанційно в черзі |
| 1013 | Повідомлення надіслано оператору, зарядка відкладена |
| 2000 | Недійсний номер джерела |
| 2001 | Короткий номер не підтримується як джерело |
| 2002 | Альфа-версія не підтримується як джерело |
| 2003 | MSISDN не підтримується як номер джерела |
| 2100 | Короткий номер не підтримується як адресат |
| 2101 | Альфа-версія не підтримується як призначення |
| 2102 | MSISDN не підтримується як адресат |
| 2103 | Операцію заблоковано |
| 2104 | Невідомий абонент |
| 2105 | Пункт призначення заблоковано |
| 2106 | Помилка номера |
| 2107 | Пункт призначення тимчасово заблоковано |
| 2108 | Недійсний пункт призначення |
| 2200 | Помилка зарядки |
| 2201 | У абонента низький баланс |
|
2202 |
Абоненту заборонено користуватися послугою за переплату (преміум)
повідомлення |
|
2203 |
Абонент занадто молодий (для цього конкретного
зміст) |
| 2204 | Передплачений абонент не допускається |
| 2205 | Послуга відхилена абонентом |
| 2206 | Абонент не зареєстрований в платіжній системі |
| 2207 | Абонент досяг максимального балансу |
| 2208 | Потрібне підтвердження кінцевого користувача |
| 2300 | Повернено |
|
2301 |
Не вдалося повернути кошти через незаконність або відсутність
MSISDN |
| 2302 | Неможливо відшкодувати через відсутність messageId |
| 2303 | У черзі на повернення коштів |
| 2304 | Час очікування відшкодування |
| 2305 | Помилка повернення коштів |
| 3000 | Кодування GSM не підтримується |
| 3001 | Кодування UCS2 не підтримується |
| 3002 | Двійкове кодування не підтримується |
| 4000 | Звіт про доставку не підтримується |
| 4001 | Недійсний вміст повідомлення |
| 4002 | Недійсний тариф |
| 4003 | Недійсні дані користувача |
| 4004 | Недійсний заголовок даних користувача |
| 4005 | Недійсне кодування даних |
| 4006 | Недійсний ПДВ |
| 4007 | Непідтримуваний вміст для призначення |
Документи / Ресурси
 |
посилання мобільність SMS API, SMPP API MS Scheduler API [pdfПосібник користувача API SMS SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |