SMS API, SMPP API MS Scheduler API
Ръководство за потребителя
SMS API, SMPP API MS Scheduler API
| Променено: | 6/24/2025 |
| Версия: | 1.7 |
| Автор: | Кени Коландер Норден, KCN |
Този документ е само за посочения получател и може да съдържа привилегирована, частна или друга лична информация. Ако сте го получили по погрешка, моля, незабавно уведомете подателя и изтрийте оригинала. Всяка друга употреба на документа от ваша страна е забранена.
История на промените
| Rev | Дата | 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 е зададено на Неизвестно по време на изпращане.
- addr_npi – стойност по подразбиране, ако NPI е зададен на Unknown по време на изпращане.
Неподдържани параметри:
- адресен_диапазон
4.2 Развързване
Командата unbind се поддържа.
4.3 Връзка за запитване
Командата за връзка за запитване се поддържа и трябва да се извиква на всеки 60 секунди.
4.4 Изпратете
Методът за изпращане трябва да се използва за доставяне на съобщения.
Необходими параметри:
- изходен_адрес_тон
- източник_addr_npi
- изходен_адрес
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- кодиране_на_данни
- sm_дължина
- кратко съобщение
Неподдържани параметри:
- тип_услуга
- protocol_id
- приоритет_флаг
- график_време_на_доставка
- замени_ако_присъства_флаг
- sm_default_msg_id
Забележка че полезният товар tag не се поддържа и може да бъде доставен само един SMS на повикване и се препоръчва валидността_период tag има стойност от поне 15 минути.
4.4.1 Препоръчителни TON и NPI
Следните TON и NPI трябва да се използват при изпращане на съобщения чрез команда за изпращане.
4.4.1.1 Източник
Следните комбинации от TON и NPI се поддържат за адрес на източника. Всички останали комбинации ще бъдат третирани като невалидни. Командата по подразбиране TON from bind ще се използва, ако TON е зададено на Unknown (0). Командата по подразбиране NPI from bind ще се използва, ако NPI е зададено на Unknown (0).
| ТОН | NPI | Описание |
| Буквено-цифрови (5) | Неизвестен (0) ISDN (1) |
Ще се третира като буквено-цифров текст на изпращача |
| международен (1) | Неизвестен (0) ISDN (1) |
Ще се третира като MSISDN |
| национален (2) Специфичен за мрежата (3) Абонатен номер (4) Съкратено (6) |
Неизвестен (0) ISDN (1) национален (8) |
Ще се третира като кратък номер, специфичен за държавата. |
4.4.1.2 Дестинация
Следните комбинации TON и NPI се поддържат за адрес на местоназначение. Всички други комбинации ще бъдат третирани като невалидни. Командата TON по подразбиране от bind ще се използва, ако TON е зададено на Неизвестно (0). NPI по подразбиране от командата за свързване ще се използва, ако NPI е зададен на Неизвестно (0).
| ТОН | NPI | Описание |
| международен (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Квотата може да бъде присвоена динамично и чрез Quota Mapping. Това съпоставя родителски QuotaId (UUID) и уникален ключ на квотата (напр. подател или потребител) с конкретен quotaId.
Квотата се определя в съответствие с вашата местна поддръжка, назначения ви мениджър на акаунти или по подразбиране, ако не е посочено нищо.
5.2 Статус 106 – Квота е превишена
SMS съобщение може да бъде блокирано със статус код 106 („квотата е превишена“), когато:
- Съобщението надвишава определения лимит за съответния quotaId в рамките на текущия интервал.
- Държавата или регионът на местоназначение нямат зададена квота (т.е. са изрично блокирани с нулево съпоставяне на квоти в програматаfile).
- Няма съответстваща квота и не е дефинирана квота по подразбиране, което води до отхвърляне.
В тези случаи системата предотвратява по-нататъшна обработка на съобщенията, за да наложи ограничения, базирани на клиента или дестинацията, и да избегне злоупотреба.
Отчет за доставка
Поддържа се само липса или окончателна доставка с успешен/неуспешен резултат.
Формат на отчета за доставка: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx дата на изпълнение: yyMMddHHmm stat:
Налични стойности в състояние:
- ДЕЛИВРД
- ИЗТЕКЛО
- ОТХВЪРЛЕНО
- НЕИЗПЕЛ
- ИЗТРИТО
6.1 Формат на разширен отчет за доставка
Разширена информация в отчетите за доставка може да бъде поискана при контакт с вашия търговски представител.
Формат на отчета за доставка: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 дата на подаване:
ггММддЧчмм дата на изпълнение: ггММддЧчмм статистика: грешка: текст:
Налични стойности в състояние:
- ДЕЛИВРД
- ИЗТЕКЛО
- ОТХВЪРЛЕНО
- НЕИЗПЕЛ
- ИЗТРИТО
Полетата „sub“ и „dlvrd“ винаги ще бъдат зададени на 000, а полето „text“ винаги ще бъде празно.
Вижте глава Кодове за грешки за стойностите на полето „грешка“.
Поддържани 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 | Сумата не може да бъде възстановена поради липсващ идентификатор на съобщението |
| 2303 | На опашка за възстановяване |
| 2304 | Време за изчакване на възстановяването |
| 2305 | Неуспешно възстановяване |
| 3000 | GSM кодирането не се поддържа |
| 3001 | UCS2 кодирането не се поддържа |
| 3002 | Двоичното кодиране не се поддържа |
| 4000 | Отчетът за доставка не се поддържа |
| 4001 | Невалидно съдържание на съобщението |
| 4002 | Невалидна тарифа |
| 4003 | Невалидни потребителски данни |
| 4004 | Невалидна заглавка на потребителските данни |
| 4005 | Невалидно кодиране на данните |
| 4006 | Невалиден ДДС |
| 4007 | Неподдържано съдържание за дестинация |
Документи / Ресурси
 |
SMS API за мобилност на връзката, SMPP API MS Scheduler API [pdf] Ръководство за потребителя SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |