SMS API, SMPP API MS Scheduler API
İstifadəçi təlimatı
SMS API, SMPP API MS Scheduler API
| Dəyişdirilib: | 6/24/2025 |
| Versiya: | 1.7 |
| Müəllif: | Kenny Colander Norden, KCN |
Bu sənəd yalnız təyin edilmiş alıcı üçündür və imtiyazlı, mülkiyyətli və ya başqa şəkildə şəxsi məlumatları ehtiva edə bilər. Əgər onu səhvən almısınızsa, lütfən, dərhal göndərənə xəbər verin və orijinalı silin. Sənədin sizin tərəfinizdən hər hansı digər istifadəsi qadağandır.
Tarixi dəyişdirin
| Rev | Tarix | By | Əvvəlki buraxılışdan dəyişikliklər |
| 1.0 | 2010-03-16 | KCN | yaradılmışdır |
| 1. | 2019-06-11 | TPE | Yenilənmiş LINK loqoları |
| 1. | 2019-09-27 | PNI | SMPP 3.4 spesifikasiyasına istinad əlavə edildi |
| 1. | 2019-10-31 | EP | Etibarlılıq müddəti ilə bağlı müşahidə tag |
| 1. | 2020-08-28 | KCN | Dəstəklənən TLS versiyaları ilə bağlı məlumat əlavə edildi |
| 2. | 2022-01-10 | KCN | Çatdırılma hesabatları ilə bağlı əlavə məlumat əlavə edildi TLS 1.3 ilə bağlı yenilənmiş məlumat |
| 2. | 2025-06-03 | GM | Nəticə kodu 2108 əlavə edildi |
| 2. | 2025-06-24 | AK | Əlavə edilmiş kvota |
Giriş
LINK Mobility 2001-ci ildən SMS distribyutorudur və həm operatorlar, həm də əlaqə aqreqatorları ilə işləməkdə böyük təcrübəyə malikdir. Bu platforma böyük trafik həcmlərini idarə etmək, yüksək əlçatanlığı qorumaq və çoxlu bağlantılar vasitəsilə trafikin marşrutunu asanlaşdırmaq üçün nəzərdə tutulmuşdur.
Bu sənəd SMSC-platforma üçün SMPP interfeysini və hansı parametrlərin və əmrlərin tələb olunduğunu və hansı parametrlərin dəstəkləndiyini təsvir edir.
Bu sənəd birləşdirilmiş mesajlar, WAPpush, Flash SMS və s. kimi xüsusi istifadə hallarını idarə etməyəcək. Həmin hallar haqqında əlavə məlumatı dəstək xidməti ilə əlaqə saxlayaraq əldə etmək olar.
Dəstəklənən əmrlər
LINK Mobility serverinə SMPP 3.4 kimi baxılmalıdır. Rəsmi spesifikasiya ilə tanış ola bilərsiniz https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Bütün üsullar dəstəklənmir və bütün fərqlər aşağıda göstərilmişdir.
4.1 Bağlamaq
Aşağıdakı bağlama əmrləri dəstəklənir.
- Transmitter
- Ötürücü
- Qəbuledici
Tələb olunan parametrlər:
- system_id – dəstəkdən əldə edilir
- parol – dəstəkdən əldə edilmişdir
Əlavə parametrlər:
- addr_ton – göndərmə zamanı TON Naməlum olaraq təyin edilibsə, standart dəyər.
- addr_npi – göndərmə zamanı NPI Naməlum olaraq təyin edilibsə, defolt dəyər.
Dəstəklənməyən parametrlər:
- ünvan_aralığı
4.2 Bağlamayın
Bağlama əmri dəstəklənir.
4.3 Sorğu linki
Sorğu bağlantısı əmri dəstəklənir və hər 60 saniyədən bir çağırılmalıdır.
4.4 Təqdim edin
Göndərmə üsulu mesajların çatdırılması üçün istifadə edilməlidir.
Tələb olunan parametrlər:
- source_addr_ton
- source_addr_npi
- mənbə_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_kodlaşdırma
- sm_uzunluq
- qısa_mesaj
Dəstəklənməyən parametrlər:
- xidmət_növü
- protokol_id
- prioritet_bayraq
- cədvəl_çatdırılma_zamanı
- əgər_əgər_əvəz et
- sm_default_msg_id
Qeyd ki, faydalı yük tag dəstəklənmir və hər zəngə yalnız bir SMS çatdırıla bilər və etibarlılıq_müddəti tövsiyə olunur tag ən azı 15 dəqiqə uzunluğunda bir dəyərə malikdir.
4.4.1 Tövsiyə olunan TON və NPI
Göndərmə əmrindən istifadə edərək mesaj göndərərkən aşağıdakı TON və NPI istifadə edilməlidir.
4.4.1.1 Mənbə
Aşağıdakı TON və NPI birləşmələri mənbə ünvanı üçün dəstəklənir. Bütün digər birləşmələr etibarsız sayılacaq. TON Naməlum (0) olaraq təyin edilərsə, bağlama əmrindən defolt TON istifadə ediləcək. NPI Naməlum (0) olaraq təyin edilərsə, bağlama əmrindən standart NPI istifadə ediləcək.
| TON | NPI | Təsvir |
| Əlifba-rəqəm (5) | Naməlum (0) ISDN (1) |
Alfasayısal göndərən mətn kimi qəbul ediləcək |
| Beynəlxalq (1) | Naməlum (0) ISDN (1) |
MSISDN kimi qəbul ediləcək |
| Milli (2) Şəbəkəyə xüsusi (3) Abunəçi nömrəsi (4) Qısaldılmış (6) |
Naməlum (0) ISDN (1) Milli (8) |
Ölkəyə xüsusi qısa nömrə kimi baxılacaq. |
4.4.1.2 Təyinat yeri
Aşağıdakı TON və NPI birləşmələri təyinat ünvanı üçün dəstəklənir. Bütün digər birləşmələr etibarsız sayılacaq. TON Naməlum (0) olaraq təyin edilərsə, bağlama əmrindən defolt TON istifadə ediləcək. NPI Naməlum (0) olaraq təyin edilərsə, bağlama əmrindən standart NPI istifadə ediləcək.
| TON | NPI | Təsvir |
| Beynəlxalq (1) | Naməlum (0) ISDN (1) |
MSISDN kimi qəbul ediləcək |
4.4.2 Dəstəklənən kodlaşdırmalar
Aşağıdakı kodlaşdırmalar dəstəklənir. X istənilən dəyəri ehtiva edə bilər.
| DCS | Kodlaşdırma |
| 0xX0 | Uzatma ilə defolt GSM əlifbası |
| 0xX2 | 8 bitlik ikili |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kvota
5.1 Kvota artıqdırview
Kvota müəyyən vaxt intervalında (məsələn, gün, həftə, ay və ya qeyri-müəyyən müddətə) göndərilə bilən SMS mesajlarının maksimum sayını müəyyən edir. Hər bir kvota quotaId (UUID) ilə unikal şəkildə müəyyən edilir və müştərinin saat qurşağına uyğun olaraq sıfırlanır. Kvota Pro vasitəsilə ölkə, region və ya defolt səviyyəsində təyin edilə bilərfile. Kvota həmçinin Kvota Xəritəçəkməsindən istifadə edərək dinamik olaraq təyin edilə bilər. Bu, ana QuotaId (UUID) və unikal kvota Açarını (məsələn, göndərən və ya istifadəçi) xüsusi kvotaId ilə əlaqələndirir.
Kvota yerli dəstəyə, təyin edilmiş hesab menecerinizə uyğun olaraq və ya heç nə göstərilmədiyi təqdirdə standart olaraq təyin edilir.
5.2 Vəziyyət 106 – Kvota keçdi
SMS mesajı 106 status kodu ilə (“kvota keçildi”) bloklana bilər:
- Mesaj cari intervalda onun müvafiq kvotası üçün müəyyən edilmiş limiti keçir.
- Təyinat ölkəsi və ya bölgəsi üçün heç bir kvota təyin edilməyib (yəni, peşəkar proqramda boş kvota xəritəsi ilə açıq şəkildə bloklanıb.file).
- Uyğun kvota yoxdur və heç bir defolt kvota müəyyən edilməyib, rədd edilməsi ilə nəticələnir.
Bu hallarda, sistem müştəri və ya təyinat üzrə məhdudiyyətləri tətbiq etmək və sui-istifadədən qaçmaq üçün mesajın sonrakı işlənməsinin qarşısını alır.
Çatdırılma hesabatı
Yalnız heç biri və ya uğurlu/uğursuz nəticə ilə yekun çatdırılma dəstəklənir.
Çatdırılma hesabatının formatı: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx bitmə tarixi: yyMMddHHmm stat:
Vəziyyətdə mövcud dəyərlər:
- ÇATDIRIN
- MÜDDƏTİ KEÇİB
- RƏDD ETMƏKD
- GERİ VERİN
- SİLİNDİ
6.1 Genişləndirilmiş çatdırılma hesabatı formatı
Çatdırılma hesabatlarında genişləndirilmiş məlumat satış nümayəndənizlə əlaqə saxlayaraq tələb oluna bilər.
Çatdırılma hesabatının formatı: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 təqdim tarixi:
yyMMddHHmm bitmə tarixi: yyMMddHHmm stat: səhv: mətn:
Vəziyyətdə mövcud dəyərlər:
- ÇATDIRIN
- MÜDDƏTİ KEÇİB
- RƏDD ETMƏKD
- GERİ VERİN
- SİLİNDİ
“alt” və “dlvrd” sahələri həmişə 000-a təyin olunacaq, “mətn” sahəsi isə həmişə boş olacaq.
“Səhv” sahəsinin dəyərləri üçün “Xəta kodları” bölməsinə baxın.
Dəstəklənən TLS versiyaları
TLS 1.2 və ya TLS 1.3 SMPP üzərindən bütün TLS əlaqələri üçün tələb olunur.
TLS 1.0 və 1.1 üçün dəstək 2020-11-15 tarixindən etibarən dayandırılır. TLS-in 1.0 və 1.1 versiyaları köhnəlmiş protokollardır və İnternet icmasında təhlükəsizlik riskləri hesab olunur.
Şifrələnməmiş SMPP bağlantıları bu gün istifadə olunursa, LINK TLS-dən istifadə etməyi tövsiyə edir. Şifrələnməmiş SMPP bağlantıları 2020-09-01 tarixindən etibarən LINK tərəfindən köhnəlib və gələcəkdə silinəcək. Şifrələnməmiş bağlantıların silinmə tarixi hələ müəyyən edilməyib.
TLS üçün SMPP serverinə qoşulmalar 3601 portunda şifrələnməmiş əvəzinə 3600 portundadır.
SMPP tətbiqiniz stunnel istifadə edərək TLS-ni dəstəkləməsə belə, hələ də TLS-dən istifadə edə bilərsiniz, baxın https://www.stunnel.org/
Səhv kodları
Sahə aktiv olduqda, səhv sahəsində aşağıdakı səhv kodları cavablandırıla bilər.
| Xəta kodu | Təsvir |
| 0 | Naməlum xəta |
| 1 | Müvəqqəti marşrut xətası |
| 2 | Daimi marşrut xətası |
| 3 | Maksimum tənzimləmə həddi keçdi |
| 4 | Taymout |
| 5 | Operatorun naməlum xətası |
| 6 | Operator xətası |
| 100 | Xidmət tapılmadı |
| 101 | İstifadəçi tapılmadı |
| 102 | Hesab tapılmadı |
| 103 | Etibarsız Şifrə |
| 104 | Konfiqurasiya xətası |
| 105 | Daxili səhv |
| 106 | Kvota keçib |
| 200 | OK |
| 1000 | Göndərildi |
| 1001 | Çatdırıldı |
| 1002 | İstifadə müddəti bitdi |
| 1003 | Silindi |
| 1004 | Mobil dolu |
| 1005 | Növbədə |
| 1006 | Çatdırılmadı |
| 1007 | Çatdırıldı, ödəniş gecikdi |
| 1008 | Dolduruldu, mesaj göndərilmədi |
| 1009 | Dolduruldu, mesaj çatdırılmadı |
| 1010 | Müddəti bitdi, operatorun çatdırılma hesabatının olmaması |
| 1011 | Dolduruldu, mesaj göndərildi (operatora) |
| 1012 | Uzaqdan növbəyə |
| 1013 | Operatora mesaj göndərildi, şarj gecikdi |
| 2000 | Yanlış mənbə nömrəsi |
| 2001 | Qısa nömrə mənbə kimi dəstəklənmir |
| 2002 | Alfa mənbə kimi dəstəklənmir |
| 2003 | MSISDN mənbə nömrəsi kimi dəstəklənmir |
| 2100 | Qısa nömrə təyinat olaraq dəstəklənmir |
| 2101 | Alpha təyinat olaraq dəstəklənmir |
| 2102 | MSISDN təyinat olaraq dəstəklənmir |
| 2103 | Əməliyyat bloklandı |
| 2104 | Naməlum abunəçi |
| 2105 | Təyinat bloklanıb |
| 2106 | Nömrə xətası |
| 2107 | Təyinat müvəqqəti olaraq bloklanıb |
| 2108 | Yanlış təyinat yeri |
| 2200 | Doldurma xətası |
| 2201 | Abunəçinin balansı azdır |
|
2202 |
Abunəçiyə həddən artıq ödəniş qoyulması qadağan edildi (mükafat)
mesajlar |
|
2203 |
Abunəçi çox gənc (bunun üçün
məzmun) |
| 2204 | Əvvəlcədən ödənişli abunəçiyə icazə verilmir |
| 2205 | Xidmət abunəçi tərəfindən rədd edildi |
| 2206 | Abunəçi ödəniş sistemində qeydiyyatdan keçməyib |
| 2207 | Abunəçi maksimum balansa çatdı |
| 2208 | Son istifadəçinin təsdiqi tələb olunur |
| 2300 | Geri qaytarıldı |
|
2301 |
Qeyri-qanuni və ya çatışmazlıq səbəbindən geri qaytarıla bilmədi
MSISDN |
| 2302 | Mesaj identifikatoru çatışmadığı üçün pulu qaytarmaq mümkün olmadı |
| 2303 | Geri qaytarmaq üçün növbəyə alınıb |
| 2304 | Geri qaytarma müddəti |
| 2305 | Geri qaytarma uğursuzluğu |
| 3000 | GSM kodlaşdırması dəstəklənmir |
| 3001 | UCS2 kodlaşdırması dəstəklənmir |
| 3002 | İkili kodlaşdırma dəstəklənmir |
| 4000 | Çatdırılma hesabatı dəstəklənmir |
| 4001 | Etibarsız mesaj məzmunu |
| 4002 | Yanlış tarif |
| 4003 | Yanlış istifadəçi məlumatları |
| 4004 | Yanlış istifadəçi məlumat başlığı |
| 4005 | Yanlış məlumat kodlaması |
| 4006 | Etibarsız ƏDV |
| 4007 | Təyinat üçün dəstəklənməyən məzmun |
Sənədlər / Resurslar
 |
əlaqə mobillik SMS API, SMPP API MS Scheduler API [pdf] İstifadəçi təlimatı SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |