СМС АПИ,СМПП АПИ МС Сцхедулер АПИ
Упутство за употребу
СМС АПИ,СМПП АПИ МС Сцхедулер АПИ
| Измењено: | 6/24/2025 |
| верзија: | 1.7 |
| Аутор: | Кени Коландер Норден, KCN |
Овај документ је само за одређеног примаоца и може да садржи привилеговане, власничке или друге приватне информације. Ако сте га примили грешком, одмах обавестите пошиљаоца и избришите оригинал. Забрањена је свака друга употреба документа.
Историја промена
| Рев | Датум | By | Промене у односу на претходно издање |
| 1.0 | 2010-03-16 | КЦН | Цреатед |
| 1. | 2019-06-11 | ТПЕ | Ажурирани логотипи ЛИНК |
| 1. | 2019-09-27 | ПНИ | Додата референца на СМПП 3.4 спецификацију |
| 1. | 2019-10-31 | EP | Запажање о року важења tag |
| 1. | 2020-08-28 | КЦН | Додате информације о подржаним верзијама ТЛС-а |
| 2. | 2022-01-10 | КЦН | Додате додатне информације у вези са извештајима о испоруци Ажуриране информације у вези са TLS 1.3 |
| 2. | 2025-06-03 | GM | Додат је код резултата 2108 |
| 2. | 2025-06-24 | AK | Додата квота |
Увод
ЛИНК Мобилити је дистрибутер СМС-а од 2001. године и има много искуства у раду и са оператерима и са агрегаторима веза. Ова платформа је дизајнирана да обрађује велике количине саобраћаја, одржава високу доступност и олакшава усмеравање саобраћаја преко више веза.
Овај документ описује SMPP интерфејс ка SMSC платформи и који параметри и команде су потребни и који параметри су подржани.
Овај документ неће обрађивати специфичне случајеве употребе као што су конкатениране поруке, WAPpush, Flash SMS итд. Више информација о тим случајевима можете добити контактирањем подршке.
Подржане команде
ЛИНК Мобилити сервер треба третирати као СМПП 3.4. Званична спецификација се може наћи на https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Све методе нису подржане, а све разлике су наведене у наставку.
4.1 Везивање
Подржане су следеће команде за повезивање.
- Предајник
- Трансциевер
- Пријемник
Потребни параметри:
- систем_ид – добијено од подршке
- лозинка – добијена од подршке
Опциони параметри:
- аддр_тон – подразумевана вредност ако је ТОН постављен на Непознато током слања.
- аддр_нпи – подразумевана вредност ако је НПИ подешен на Непознато током слања.
Неподржани параметри:
- опсег_адресе
4.2 Одвезивање
Команда унбинд је подржана.
4.3 Веза за упит
Команда упита за везу је подржана и треба је позивати сваких 60 секунди.
4.4 Пошаљите
За испоруку порука треба користити метод слања.
Потребни параметри:
- соурце_аддр_тон
- соурце_аддр_нпи
- соурце_аддр
- дест_аддр_тон
- дест_аддр_нпи
- дест_аддр
- есм_цласс
- дата_цодинг
- см_ленгтх
- кратка порука
Неподржани параметри:
- сервис Тип
- протоцол_ид
- приорити_флаг
- распоред_време_испоруке
- реплаце_иф_пресент_флаг
- см_дефаулт_мсг_ид
Напомена да носивост tag није подржано и само један СМС може бити испоручен по позиву и препоручује се да период ваљаности tag има вредност од најмање 15 минута.
4.4.1 Препоручени ТОН и НПИ
Следећи ТОН и НПИ треба да се користе приликом слања порука помоћу команде за слање.
4.4.1.1 Извор
Следеће комбинације TON и NPI су подржане за изворну адресу. Све остале комбинације ће се третирати као неважеће. Подразумевана команда TON from bind ће се користити ако је TON подешен на Непознато (0). Подразумевана команда NPI from bind ће се користити ако је NPI подешен на Непознато (0).
| ТОН | НПИ | Опис |
| Алфанумерички (5) | Непознато (0) ISDN (1) |
Третираће се као алфанумерички текст пошиљаоца |
| међународни (1) | Непознато (0) ISDN (1) |
Третираће се као МСИСДН |
| национални (2) Специфично за мрежу (3) Број претплатника (4) Скраћено (6) |
Непознато (0) ISDN (1) национални (8) |
Третираће се као кратки број за одређену земљу. |
4.4.1.2 Одредиште
Следеће комбинације ТОН и НПИ су подржане за одредишну адресу. Све остале комбинације ће се третирати као неважеће. Подразумевана команда ТОН фром бинд ће се користити ако је ТОН подешен на Непознато (0). Подразумевана команда НПИ фром бинд ће се користити ако је НПИ подешен на Непознато (0).
| ТОН | НПИ | Опис |
| међународни (1) | Непознато (0) ISDN (1) |
Третираће се као МСИСДН |
4.4.2 Подржана кодирања
Подржана су следећа кодирања. Кс може садржати било коју вредност.
| ДЦС | Енцодинг |
| 0кКс0 | Подразумевана ГСМ абецеда са екстензијом |
| 0кКс2 | 8-битни бинарни |
| 0кКс8 | УЦС2 (ИСО-10646-УЦС-2) |
Квота
5.1 Квота прекораченаview
Квота дефинише максималан број СМС порука које се могу послати у одређеном временском интервалу (нпр. дневно, недељно, месечно или на неодређено време). Свака квота је јединствено идентификована помоћу quotaId-а (UUID) и ресетује се у складу са временском зоном клијента. Квоте се могу доделити на нивоу земље, региона или подразумеваног нивоа путем Quota Pro-а.fileКвота се такође може динамички доделити помоћу мапирања квота. Ово мапира родитељски QuotaId (UUID) и јединствени кључ квоте (нпр. пошиљалац или корисник) на одређени quotaId.
Квота се подешава у складу са вашом локалном подршком, вашим додељеним менаџером налога или подразумевано ако ништа није наведено.
5.2 Статус 106 – Квота прекорачена
СМС порука може бити блокирана са статусним кодом 106 („квота прекорачена“) када:
- Порука прелази дефинисано ограничење за одговарајући quotaId унутар тренутног интервала.
- Земља или регион одредишта нема додељену квоту (тј. експлицитно је блокиран мапирањем нулте квоте у програмуfile).
- Не постоји одговарајућа квота и није дефинисана подразумевана квота, што резултира одбијањем.
У овим случајевима, систем спречава даљу обраду порука како би се спровела ограничења заснована на купцу или одредишту и избегла злоупотреба.
Известај о испоруци
Подржана је само никаква или коначна испорука са успешним/неуспешним резултатом.
Формат извештаја о испоруци: ид: кккккккккккккккккккккккккккккккккк датум завршетка: ииММддХХмм стат:
Доступне вредности у статусу:
- ДЕЛИВРД
- ИСТЕКЛО
- РЕЈЕЦТД
- УНДЕЛИВ
- ДЕЛЕТЕД
6.1 Формат извештаја о проширеној испоруци
Проширене информације у извештајима о испоруци можете затражити у контакту са вашим представником продаје.
Формат извештаја о испоруци: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 датум слања:
ггММддХХмм завршено датум: ггММддХХмм статистика: грешка: текст:
Доступне вредности у статусу:
- ДЕЛИВРД
- ИСТЕКЛО
- РЕЈЕЦТД
- УНДЕЛИВ
- ДЕЛЕТЕД
Поља „суб“ и „длврд“ ће увек бити постављена на 000, а поље „тект“ ће увек бити празно.
Погледајте поглавље Кодови грешака за вредности за поље „ерр“.
Подржане ТЛС верзије
ТЛС 1.2 или ТЛС 1.3 је неопходан за све ТЛС везе преко СМПП-а.
Подршка за ТЛС 1.0 и 1.1 је укинута од 2020-11-15. Верзије 1.0 и 1.1 ТЛС-а су старији протоколи који су застарели и сматрају се безбедносним ризицима у Интернет заједници.
ЛИНК топло препоручује да користите ТЛС ако се данас користе нешифроване СМПП везе. Нешифроване СМПП везе су застареле од 2020 од стране ЛИНК-а и биће уклоњене у будућности. Датум за уклањање нешифрованих веза још није одређен.
Везе ка СМПП серверу за ТЛС су на порту 3601 уместо нешифроване на порту 3600.
И даље можете да користите ТЛС чак и ако ваша СМПП имплементација не подржава ТЛС користећи стуннел, погледајте https://www.stunnel.org/
Кодови грешака
Следећи кодови грешака се могу одговорити у пољу за грешку ако је поље омогућено.
| Код грешке | Опис |
| 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 | МСИСДН није подржан као изворни број |
| 2100 | Кратки број није подржан као одредиште |
| 2101 | Алфа није подржана као одредиште |
| 2102 | МСИСДН није подржан као одредиште |
| 2103 | Операција блокирана |
| 2104 | Непознати претплатник |
| 2105 | Одредиште је блокирано |
| 2106 | Грешка у броју |
| 2107 | Одредиште је привремено блокирано |
| 2108 | Неважеће одредиште |
| 2200 | Грешка при пуњењу |
| 2201 | Претплатник има низак баланс |
|
2202 |
Претплатник забрањен због прекомерне наплате (премијум)
поруке |
|
2203 |
Претплатник је превише млад (за ово конкретно
садржај) |
| 2204 | Припејд претплатник није дозвољен |
| 2205 | Претплатник је одбио услугу |
| 2206 | Претплатник није регистрован у платном систему |
| 2207 | Претплатник је достигао максималан баланс |
| 2208 | Потребна је потврда крајњег корисника |
| 2300 | Рефундирано |
|
2301 |
Повраћај новца није могућ због незаконитог или недостајућег
МСИСДН |
| 2302 | Није могуће рефундирати због недостатка ИД-а поруке |
| 2303 | У реду за повраћај новца |
| 2304 | Рефунд тимеоут |
| 2305 | Повраћај новца није успео |
| 3000 | ГСМ кодирање није подржано |
| 3001 | УЦС2 кодирање није подржано |
| 3002 | Бинарно кодирање није подржано |
| 4000 | Извештај о испоруци није подржан |
| 4001 | Неважећи садржај поруке |
| 4002 | Неважећа тарифа |
| 4003 | Неважећи кориснички подаци |
| 4004 | Неважеће заглавље корисничких података |
| 4005 | Неважеће кодирање података |
| 4006 | Неважећи ПДВ |
| 4007 | Неподржан садржај за одредиште |
Документи / Ресурси
 |
линк мобилност СМС АПИ,СМПП АПИ МС Сцхедулер АПИ [пдф] Упутство за кориснике СМС АПИ СМПП АПИ МС Сцхедулер АПИ, СМС АПИ СМПП АПИ, МС Сцхедулер АПИ, Сцхедулер АПИ, АПИ |