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 е СМС дистрибутер од 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 е поставена на Непознат при поднесување.
Неподдржани параметри:
- опсег на адреса
4.2 Одврзување
Командата unbind е поддржана.
4.3 Врска за распрашување
Командата за барање врска е поддржана и треба да се повикува на секои 60 секунди.
4.4 Поднеси
Методот на испраќање треба да се користи за доставување пораки.
Потребни параметри:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- податоци_кодирање
- sm_должина
- кратка_порака
Неподдржани параметри:
- услуга_тип
- protocol_id
- приоритет_знаме
- распоред_време_испорака
- замени_ако_присутно_знаме
- sm_default_msg_id
Забелешка дека носивоста tag не е поддржан и може да се достави само една СМС по повик и се препорачува периодот_валидност tag има вредност од најмалку 15 минути.
4.4.1 Препорачани TON и NPI
Следниве TON и NPI треба да се користат при испраќање пораки користејќи команда за поднесување.
4.4.1.1 Извор
Следните комбинации на TON и NPI се поддржани за изворна адреса. Сите други комбинации ќе се третираат како неважечки. Стандардниот TON од командата за поврзување ќе се користи ако TON е поставен на Непознато (0). Стандардниот NPI од командата за поврзување ќе се користи ако NPI е поставен на Непознато (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 од bind ќе се користи ако NPI е поставена на Unknown (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Квотата може динамички да се додели со користење на мапирање на квоти. Ова мапира родителски QuotaId (UUID) и уникатен клуч за квота (на пр., испраќач или корисник) на одреден quotaId.
Квотата се поставува во согласност со вашата локална поддршка, вашиот назначен менаџер на сметки или по дифолт ако ништо не е наведено.
5.2 Статус 106 – Квотата е надмината
СМС пораката може да биде блокирана со статусен код 106 („надмината квота“) кога:
- Пораката го надминува дефинираното ограничување за нејзиниот соодветен quotaId во рамките на тековниот интервал.
- Дестинацискиот регион или земја нема доделена квота (т.е. е експлицитно блокиран со мапирање на нулта квота во проfile).
- Нема соодветна квота и не е дефинирана стандардна квота, што резултира со отфрлање.
Во овие случаи, системот спречува понатамошна обработка на пораките за да ги спроведе ограничувањата базирани на клиентот или дестинацијата и да избегне злоупотреба.
Извештај за испорака
Поддржана е само никаква или конечна испорака со успешен/неуспешен резултат.
Формат на извештај за испорака: ID: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx “
Достапни вредности во статус:
- ДЕЛИВРД
- ИСТЕРЕН
- ОДБИЕ
- НЕДЕЛИВ
- ИЗБРИШЕНО
6.1 Проширен формат на извештај за испорака
Може да се побараат проширени информации во извештаите за испорака во контакт со вашиот претставник за продажба.
Формат на извештај за испорака: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 датум на поднесување:
yyMMddHHmm датум на завршување: yyMMddHHmm статистика: греши: текст:
Достапни вредности во статус:
- ДЕЛИВРД
- ИСТЕРЕН
- ОДБИЕ
- НЕДЕЛИВ
- ИЗБРИШЕНО
Полињата „sub“ и „dlvrd“ секогаш ќе бидат поставени на 000, а полето „текст“ секогаш ќе биде празно.
Видете го поглавјето Кодови за грешки за вредностите за полето „грешка“.
Поддржани верзии на TLS
TLS 1.2 или TLS 1.3 е потребен за сите TLS врски преку SMPP.
Поддршката за TLS 1.0 и 1.1 е прекината од 2020. Верзиите 11 и 15 на TLS се постари протоколи кои се застарени и се сметаат за безбедносни ризици во Интернет заедницата.
LINK силно препорачуваме да користите TLS ако денес се користат нешифрирани SMPP конекции. Нешифрираните SMPP врски се застарени од 2020 година преку LINK и ќе бидат отстранети во иднина. Датумот за отстранување на нешифрирани врски сè уште не е одлучен.
Врските кон серверот SMPP за TLS се на портата 3601 наместо нешифрирани на портата 3600.
Сè уште можете да користите TLS, дури и ако вашата имплементација на SMPP не поддржува TLS со користење на stunnel, видете 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 | MSISDN не е поддржан како изворен број |
| 2100 | Краткиот број не е поддржан како дестинација |
| 2101 | Алфа не е поддржана како дестинација |
| 2102 | MSISDN не е поддржан како дестинација |
| 2103 | Операцијата е блокирана |
| 2104 | Непознат претплатник |
| 2105 | Дестинацијата е блокирана |
| 2106 | Грешка со број |
| 2107 | Дестинацијата е привремено блокирана |
| 2108 | Неважечка дестинација |
| 2200 | Грешка при полнење |
| 2201 | Претплатникот има ниско салдо |
|
2202 |
Претплатникот е блокиран поради преплатено (премиум)
пораки |
|
2203 |
Претплатникот е премногу млад (за ова конкретно)
содржина) |
| 2204 | Припејд претплатникот не е дозволен |
| 2205 | Услугата е одбиена од претплатникот |
| 2206 | Претплатникот не е регистриран во платниот систем |
| 2207 | Претплатникот достигна максимално салдо |
| 2208 | Потребна е потврда од краен корисник |
| 2300 | Рефундирање |
|
2301 |
Не може да се вратат парите поради нелегално или недостасувачко
MSISDN |
| 2302 | Не може да се вратат средствата поради исчезнатиот ID на пораката |
| 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 |