LINK Mobility Tətbiq Bələdçisi REST API SMS
LINK Mobility mesajın çatdırılması, mikro ödənişlər və məkana əsaslanan xidmətlər üçün xidmət təqdim edir. Platforma Xidmət Provayderləri və Operatorlar arasında şəffaf, ağ etiketli məzmun alıcısı və tranzaksiya yönləndiricisi kimi çıxış edir.
LINK Mobility SMS göndərmək kimi LINK Mobility xidmətlərinə daxil olmaq üçün istifadə edilə bilən RESTful API təmin edir. Bu API istifadəsi asan və bütün müasir dillər və çərçivələrlə uyğun olmaq üçün hazırlanmışdır. Seçdiyiniz dildən istifadə edərək, tətbiqiniz güclü mesajlaşma və ödəniş imkanlarını həyata keçirmək üçün Link Mobility REST API-dən istifadə edə bilər.
© LINK Mobility, 10 mart 2021-ci il
Hüquqi məlumat
Bu sənəddə təqdim olunan məlumat Netsize şirkətinin yeganə mülkiyyəti və müəllif hüquqlarıdır. O, məxfidir və ciddi şəkildə məlumat məqsədləri üçün istifadə üçün nəzərdə tutulub. O, məcburi deyil və xəbərdarlıq edilmədən dəyişikliklərə məruz qala bilər. Hər hansı icazəsiz açıqlama və ya istifadə qanunsuz hesab olunur.
Netsize™ və linkmobility™ Fransa, AET və beynəlxalq əqli mülkiyyət qanunları ilə qorunur.
Göstərilən bütün digər ticarət nişanları müvafiq sahiblərinin yeganə mülkiyyətidir.
Buradakı heç bir şey Netsize patenti, müəllif hüququ və ya ticarət nişanı altında hər hansı lisenziya və ya hüququn verilməsi kimi təfsir edilməməlidir.
ÖLÇÜSÜ
Société anonim və ya kapital 5 478 070 avro
Mühasirə sosial :62, prospekt Emile Zola92100 Boulogne – Fransa
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Sənədin əhatə dairəsi
Bu sənəd Xidmət Provayderinin SMS üçün LINK Mobility REST API-dən necə istifadə etdiyini təsvir edir. O, Xidmət Provayderinin xidmətlərini həyata keçirən texniki memarlar və dizaynerlər üçün nəzərdə tutulub.
1. Əsas İstifadə
SMS göndərmək çox asandır. Siz LINK Mobility-ə HTTP sorğusu göndərirsiniz ki, bu da yalnız a web brauzer.
2. Funksional bitdiview
LINK Mobility sistemi SMS mesajları üçün aşağıdakı əsas funksiyaları təmin edir:
Mətn və ya ikili (məsələn, WAP Push) premium və standart tarif mesajları kimi Mobil Sonlandırılmış (MT) SMS mesajlarının göndərilməsi.
Təqdim edilmiş MT mesajları üçün çatdırılma hesabatlarının qəbulu.
Mobile Originated (MO) SMS mesajları, premium və standart tariflərin qəbulu.
SMS REST API standart MT SMS mesajlarının göndərilməsinə həsr edilmişdir.
API bütün SMS mesajlarını asinxron olaraq göndərir və aşağıdakı funksiyaları işə salır:
“Yandır və unut” – Xidmət Provayderi daha proqnozlaşdırıla bilən cavab vaxtlarına sahib olmaq istəyir və Operatordan nəticə gözləmək istəmir.
Yenidən cəhd funksiyası – Operatorda müvəqqəti problemlər olarsa, LINK Mobility mesajı yenidən göndərəcək.
2.1 SMS mesajının göndərilməsi
Xidmət Provayderi Netsize Consumer
- MT mesajı göndərin
- Mesaj identifikatorunu qaytarın
- SMS göndərin
- Çatdırılma hesabatını təqdim edin
- Çatdırılma hesabatını göndərin
SMS mesajlarının göndərilməsinin əsas axını aşağıdakı kimi təsvir edilmişdir:
Xidmət Provayderi LINK Mobility sistemi vasitəsilə alıcıya SMS mesajı göndərmək üçün sorğu göndərir.
Mesaj ID-si Xidmət Provayderinə qaytarılır. Bu ID, məsələn, mesajı düzgün çatdırılma hesabatı ilə əlaqələndirmək üçün istifadə edilə bilər.
LINK Mobility marşrutlaşdırmanı idarə edir və SMS mesajını ünvanlanmış İstehlakçıya çatdırır.
Çatdırılma hesabatı işə salınır, məsələn, SMS mesajı İstehlakçının cihazına çatdırıldıqda.
Çatdırılma hesabatı Xidmət Provayderinə göndərilir. Hesabat 2-ci addımda qaytarılan eyni mesaj identifikatorunu ehtiva edir.
Alternativ axın: Yanlış sorğu
Sorğuda təqdim edilmiş parametrlər və ya istifadəçi etimadnaməsi etibarsızdırsa, xəta Xidmət Provayderinə qaytarılır. Səhv imtinanın səbəbini göstərir və axın başa çatır. Heç bir mesaj identifikatoru qaytarılmır.
3. Son nöqtə
SMS resursuna aşağıdakı yoldan istifadə etməklə daxil olur:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Bağlantı təhlükəsizliyi üçün LINK Mobility REST API-yə yalnız HTTPS vasitəsilə daxil olmaq mümkündür.
Link Mobility server sertifikatı Thawte Server CA tərəfindən imzalanır.
4. Əməliyyatlar
SMS xidməti aşağıdakı əməliyyatları həyata keçirir:
| ad | Yol |
| Göndər | /restapi/v1/sms/göndər |
4.1 Göndər
Göndərmə əməliyyatı tək bir alıcıya SMS göndərmək üçün istifadə olunur.
Bu əməliyyat həm əsas, həm də qabaqcıl istifadəçilər üçün nəzərdə tutulub. Ən sadə halda, SMS çatdırmaq üçün yalnız təyinat ünvanı və mesaj mətni tələb olunur. LINK Mobility Məlumat Kodlaşdırma Sxemini aşkar edəcək və lazım gələrsə mesajın bir neçə mesaj hissəsinə avtomatik birləşməsini həyata keçirəcək.
Qabaqcıl istifadə üçün Xidmət Provayderi istifadəçi məlumat başlığı daxil olmaqla mesaj formatına tam nəzarət etmək üçün əlavə parametrlərdən istifadə edə bilər.
Xidmət Provayderi birləşdirilmiş mesajlar göndərə bilər, lakin istifadəçi məlumatlarının və istifadəçi məlumatlarının başlığının hazırlanması Xidmət Provayderi tərəfindən həyata keçirilməli və mesaj LINK Mobility-ə çoxsaylı göndərmə sorğuları vasitəsilə göndərilməlidir.
5. Doğrulama
İstifadəçi adı və parol HTTP Əsas Doğrulama Sxemindən istifadə edərək hər sorğuda təqdim olunur.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Etibarnamələr HTTP sorğusunda Avtorizasiya başlığında göndərilir. Müştəri başlıq sahəsini burada təsvir edildiyi kimi qurur:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
məsələnampƏgər istifadəçi adı john, changeme isə paroldursa, nəticədə Avtorizasiya başlığı belədir:
Avtorizasiya: Əsas am9objpjaGFuZ2VtZSA=
Geri qaytarılma kimi istifadəçi adı və parol sorğu parametrləri kimi təqdim edilə bilər. Bu, yalnız Basic Auth-u dəstəkləməyən müştərilər üçün tövsiyə olunur.
6. Sorğunun təqdim edilməsi
6.1 Sorğu sətri
Sorğu parametrləri ad/dəyər cütlərindən ibarət sorğu sətri kimi təqdim olunur. Sorğu sətri Faiz Kodlaşdırması ilə kodlanır (URL kodlaşdırma).
http://www.w3schools.com/tags/ref_urlencode.asp
məsələnample, Salam Dünya! Hello+World%21 kimi kodlanır.
6.2 Məcburi sorğu parametrləri
| ad | Maksimum uzunluq | Təsvir |
| təyinat ünvanı | 40 | Ölkə kodundan başlayaraq SMS mesajının göndərilməli olduğu MSISDN. Məsampəlaqə nömrəsi: 46123456789. Bəzi bazarlar üçün (İstehlakçı MSISDN-nin gizlədilməli olduğu yerlərdə) bu dəyər həm də “#” prefiksli alfasayısal ləqəb ola bilər. |
| mesaj mətni | 1600 | SMS məzmunu. |
6.3 Əlavə sorğu parametrləri (qabaqcıl istifadə üçün)
| ad | Maksimum uzunluq | Təsvir |
| mənşəli Ünvan | 16 | Gedən SMS mesajının başlanğıc ünvanı. Başlanğıc ünvanın növü originalatorTON parametri ilə müəyyən edilir. Qısa nömrənin maksimum uzunluğu 16-dır. Alfa-rəqəm göndəricisi maksimum uzunluğu 11 simvol olan GSM defolt Əlifbası ilə məhdudlaşır. MSISDN göndəricisinin maksimum uzunluğu 15-dir (destinationAddress elementi ilə eyni formatdan istifadə etməklə). OrigatingAddress və originatingTON sistem tərəfindən seçildikdə buraxıla bilər. Bu funksiya bazardan və konfiqurasiyadan asılıdır. Davranış Operator inteqrasiyaları ilə fərqlənə bilər. |
| yaradıcıTON | 1 | Mənbə ünvanının nömrə növü (TON): 0 – Qısa nömrə 1 – Alfa-rəqəm (maksimum uzunluq 11) 2 – MSISDN OriginatingAddress və originatingTON sistem tərəfindən seçilərkən buraxıla bilər. Bu funksiya bazardan və konfiqurasiyadan asılıdır. Davranış Operator inteqrasiyaları ilə fərqlənə bilər. |
| userDataHeader | 280 | İstifadəçi Məlumatı Başlığı İstifadəçi Məlumatı ilə birlikdə 140-a qədər, yəni hex-kodlaşdırıldıqda 280-ə qədər oktet ehtiva edə bilər. Bu parametr həmişə hex kodludur. |
| DCS | 3 | Məlumatların kodlaşdırılması sxemi. Davranış Operator inteqrasiyaları ilə fərqlənə bilər. |
| PID | 3 | Protokol ID. Davranış Operator inteqrasiyaları ilə fərqlənə bilər. |
| NisbiValidityTime | 6 | Nisbi etibarlılıq müddəti saniyələrlə (LINK Mobility-ə təqdimetmə vaxtı ilə müqayisədə). Maksimum dəyər 604800 (7 gün) və standart 48 saatdır. Davranış Operator inteqrasiyaları ilə fərqlənə bilər. |
| çatdırılma vaxtı | 20 | Zamanamp SMS mesajı çatdırılmalı olduqda (gecikmiş çatdırılma vaxtı). Tarix vaxtı formatı bölməsinə baxın. |
| statusReportBayraqlar | 1 | Hesabat sorğusunu çatdırın: 0 – Çatdırılma hesabatı yoxdur (standart) 1 – Çatdırılma hesabatı tələb olunur 9 – Server çatdırılması hesabatı tələb olunur (LINK Mobility hesabatı Xidmət Provayderinə yönləndirmir, lakin onu hesabatlarda və s. |
| campaignName | 50 | LINK Mobility əməliyyatları bunlardır tagbu adla gedin. Link Mobility hesabatlarında əməliyyatları qruplaşdırmaq üçün istifadə olunur. |
| maxConcatenatedMessages | 1 | 1 ilə 10 arasındakı dəyər, nə qədər birləşdirilmiş mesaja icazə verildiyini müəyyən edir. Defolt 3-dür. |
| korrelyasiyaId | 100 | Çatdırılma Hesabatında əks olunacaq Xidmət Provayderi tərəfindən təqdim edilən ID. |
| istifadəçi adı | 100 | HTTP Əsas Doğrulamaya alternativ olaraq təqdim olunur. |
| parol | 100 | HTTP Əsas Doğrulamaya alternativ olaraq təqdim olunur. |
6.4 HTTP Sorğu Metodları
Maksimum qarşılıqlı fəaliyyət üçün API həm HTTP GET, həm də POST sorğu metodlarını dəstəkləyir. Başqa heç bir HTTP metoduna icazə verilmir.
6.4.1 GET
Kodlanmış sorğu sətri əlavə olunur URL.
GET
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Salam+Dünya%21
Avtorizasiya: Əsas am9objpjaGFuZ2VtZSA=
6.4.2 POST
Şifrələnmiş sorğu sətri HTTP sorğu mesajı orqanında təqdim olunur. Məzmun növü tətbiqdir/x-www-form-urlkodlanmış.
POST https://europe.ipx.com/restapi/v1/sms/send
Ev sahibi: europe.ipx.com
Məzmun növü: tətbiq / x-www-form-urlkodlanmış
Avtorizasiya: Əsas am9objpjaGFuZ2VtZSA=
Məzmun uzunluğu: 57
destinationAddress=46123456789&messageText=Salam+Dünya%21
6.5 Tarix və vaxt
Tarix və vaxtı təmsil edən REST API-də parametrlər həmişə UTC saat qurşağındadır (Koordinasiya edilmiş Universal Saat). Zamanamps bu dəqiq formatla sətir kimi təmsil olunur:
2017-04-25T23:20:50Z
Bu, UTC-də 20 aprel 50-ci il, 23-cü saatdan sonra 25 dəqiqə 2017 saniyəni əks etdirir.
7. Cavab mesajı
Sorğu mesajını qəbul etdikdən və şərh etdikdən sonra API HTTP cavab mesajı ilə cavab verir.
7.1 HTTP status kodu
REST API həmişə işlənmiş sorğular üçün HTTP status kodu 200 OK qaytarır. Mesaj gövdəsində dəqiq nəticəni müəyyən etmək üçün istifadə olunan cavab kodu parametri var.
7.2 Mesajın mətni
Mesaj gövdəsi sorğunun nəticəsini təsvir edən JSON-dan ibarətdir.
http://json.org/
Link Mobility JSON Google JSON Style Guide ilə uyğun gəlir.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Cavab parametrləri
| ad | Maksimum uzunluq | Təsvir |
| cavab kodu | 3 | 0 uğurlu əməliyyatı göstərir. |
| cavab mesajı | 255 | Cavab mətninin təsviri, məsələn, səhv mətni. |
| vaxtamp | 20 | LINK Mobility sorğunu emal etdiyi tarix və vaxt. (Tarix/vaxt formatı bölməsinə baxın). |
| traceId | 36 | Link Mobility daxili identifikatoru. Dəstək və problemlərin aradan qaldırılması üçün istifadə olunur. |
| mesaj idləri | 10 x 36 | Hər bir uğurlu mesaj üçün LINK Mobility unikal mesaj identifikatorları massivi (mesaj birləşdirildikdə birdən çox mesaj identifikatoru qaytarılır). Uğursuzluq halında buraxılır. |
7.4 Çıxışampcavablar
Uğur
HTTP/1.1 200 OK
Məzmun növü: proqram/json
Məzmun uzunluğu: 144
Tarix: Cümə axşamı, 15 Sentyabr 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Uğur”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Budur oxunaqlılıq üçün formatlanmış eyni JSON:
{
“cavab kodu“: 0,
“cavab mesajı":"Uğur",
“vaxtamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“mesaj idləri“:[“1-4850879008”] }
Uğursuzluq
HTTP/1.1 200 OK
Məzmun növü: proqram/json
Məzmun uzunluğu: 148
Tarix: Cümə axşamı, 15 Sentyabr 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Yanlış giriş və ya icazəsiz API istifadəsi”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Uğur
HTTP/1.1 200 OK
Məzmun növü: proqram/json
Məzmun uzunluğu: 144
Tarix: Cümə axşamı, 15 Sentyabr 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Uğur”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Budur oxunaqlılıq üçün formatlanmış eyni JSON:
{
“cavab kodu“: 0,
“cavab mesajı":"Uğur",
“vaxtamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“mesaj idləri“:[“1-4850879008”] }
Uğursuzluq
HTTP/1.1 200 OK
Məzmun növü: proqram/json
Məzmun uzunluğu: 148
Tarix: Cümə axşamı, 15 Sentyabr 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Yanlış giriş və ya icazəsiz API istifadəsi”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Cavab kodları
Aşağıdakı cavab kodları göndərmə cavabında qaytarıla bilər:
| Kod | Mətn | Təsvir |
| 0 | Uğur | Uğurla icra olundu. |
| 1 | Yanlış giriş və ya icazəsiz API istifadəsi | Yanlış istifadəçi adı və ya parol və ya Xidmət Provayderi LINK Mobility tərəfindən qadağan edilib. |
| 2 | İstehlakçı Link Mobility tərəfindən bloklanıb | İstehlakçı LINK Mobility tərəfindən bloklanıb. |
| 3 | Əməliyyat LINK Mobility tərəfindən təmin edilmir | Əməliyyat Xidmət Provayderi üçün bloklanıb. |
| 4 | İstehlakçı LINK Mobility-ə məlum deyil | İstehlakçı LINK Mobility-ə məlum deyil. Və ya sorğuda ləqəbdən istifadə olunubsa; ləqəb tapılmadı. |
| 5 | İstehlakçı bu xidməti LINK Mobility-də bloklayıb | İstehlakçı bu xidməti LINK Mobility-də bloklayıb. |
| 6 | Mənbə ünvanı dəstəklənmir | Mənbə ünvanı dəstəklənmir. |
| 7 | Alfa mənşəli ünvan hesab tərəfindən dəstəklənmir | Alfa mənşəli ünvan hesab tərəfindən dəstəklənmir. |
| 8 | MSISDN mənşəli ünvan dəstəklənmir | MSISDN mənşəli ünvan dəstəklənmir. |
| 9 | Genişləndirilmiş GSM dəstəklənmir | Genişləndirilmiş GSM dəstəklənmir. |
| 10 | Unicode dəstəklənmir | Unicode dəstəklənmir. |
| 11 | Status hesabatı dəstəklənmir | Status hesabatı dəstəklənmir. |
| 12 | Tələb olunan qabiliyyət dəstəklənmir | Mesajın göndərilməsi üçün tələb olunan imkanlar (yuxarıda göstərilənlərdən başqa) dəstəklənmir. |
| 13 | Məzmun provayderinin maksimal tənzimləmə sürəti keçib | Xidmət Provayderi SMS mesajlarını LINK Mobility-ə çox sürətli göndərir. |
| 14 | Protokol ID-si hesab tərəfindən dəstəklənmir | Protokol ID-si dəstəklənmir. |
| 15 | Mesaj birləşmə limitini keçib | Birləşdirilmiş mesajların sayı tələb olunan maksimum sayını keçir. |
| 16 | Mesajı yönləndirmək mümkün deyil. | LINK Mobility mesajı yönləndirə bilmədi. |
| 17 | Qadağan olunmuş müddət | Müddət ərzində mesaj göndərməyə icazə verilmir |
| 18 | Xidmət provayderi hesabında balans çox aşağıdır | Balans çox aşağı olduğuna görə xidmət təminatçısı bloklanıb |
| 50 | Qismən uğur | Birdən çox alıcıya SMS göndərərkən qismən müvəffəqiyyət. |
| 99 | Daxili server xətası | Digər Link Mobility xətası, əlavə məlumat üçün LINK Mobility dəstəyi ilə əlaqə saxlayın. |
| 100 | Yanlış təyinat ünvanı | Təyinat ünvanı (MSISDN və ya ləqəb) yanlışdır. |
| 102 | Yanlış istinad edilmiş (əlaqələndirilmiş) ID | İstinad ID-si etibarsızdır, ola bilsin ki, istinad ID-si artıq istifadə olunub, çox köhnə və ya naməlumdur. |
| 103 | Yanlış hesab adı | Hesab adı yanlışdır. |
| 105 | Yanlış xidmət meta datası | Xidmət meta datası etibarsızdır. |
| 106 | Yanlış mənbə ünvanı | Mənbə ünvanı etibarsızdır. |
| 107 | Yanlış hərf-rəqəm mənşəli ünvan | Alfasayısal mənbə ünvanı etibarsızdır. |
| 108 | Etibarsızlıq müddəti | Etibarlılıq müddəti etibarsızdır. |
| 109 | Yanlış çatdırılma vaxtı | Çatdırılma vaxtı etibarsızdır. |
| 110 | Etibarsız mesaj məzmunu/istifadəçi datası | İstifadəçi məlumatları, yəni SMS mesajı etibarsızdır. |
| 111 | Yanlış mesaj uzunluğu | SMS mesaj uzunluğu yanlışdır. |
| 112 | Yanlış istifadəçi məlumat başlığı | İstifadəçi məlumat başlığı yanlışdır. |
| 113 | Yanlış məlumat kodlaşdırma sxemi | DCS etibarsızdır. |
| 114 | Etibarsız protokol ID | PID etibarsızdır. |
| 115 | Etibarsız status hesabatı bayraqları | Status hesabatı bayraqları etibarsızdır. |
| 116 | Yanlış TON | Yaradıcı TON etibarsızdır. |
| 117 | Yanlış campaign adı | campaign adı etibarsızdır. |
| 120 | Birləşdirilmiş mesajların maksimum sayı üçün etibarsız limit | Birləşdirilmiş mesajların maksimum sayı etibarsızdır. |
| 121 | Yanlış msisdn mənşəli ünvan | MSISDN mənşəli ünvan etibarsızdır. |
| 122 | Yanlış korrelyasiya ID | Korrelyasiya ID-si yanlışdır. |
8. Əlavə xüsusiyyətlər
8.1 MSISDN korreksiyası
MSISDN korreksiyası, tələb olunarsa, LINK Mobility dəstəyi ilə aktivləşdirilə bilən əlavə xüsusiyyətdir.
Bu funksiya təyinat ünvanlarını düzəldəcək və onları tələb olunan E.164 formatına uyğunlaşdıracaq. Format korreksiyasına əlavə olaraq sistem, müvafiq hallarda DOM-TOM (départements et territoires d'outre-mer) nömrələrini düzəltmək üçün beynəlxalq fransız nömrələrini tərcümə etmək kimi bazara xas funksiyaları yerinə yetirə bilər.
Aşağıda bir sıra keçmiş varampdüzəlişlər:
| Təqdim edilmiş Təyinat Ünvanı | Düzəliş edilmiş təyinat ünvanı |
| +46(0)702233445 | 46702233445 |
| (0046) 72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (Fransız nömrəsi DOM-TOM nömrəsinə tərcümə edilmişdir) |
Bundan əlavə, seçilmiş bazar üçün milli telefon nömrələrinə icazə vermək mümkündür. Bu funksiya aktiv olduqda, digər bazarlar üçün hər hansı beynəlxalq nömrələr seçilmiş bazardan fərqləndirmək üçün ilkin `+' işarəsi ilə göndərilməlidir.
Aşağıda bir neçə keçmiş varampİsveçdən (ölkə kodu 46) milli nömrələr üçün standart bazar kimi istifadə edildikdə edilən düzəlişlər.
| Təqdim edilmiş Təyinat Ünvanı | Düzəliş edilmiş təyinat ünvanı |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | "+" işarəsi olmadığı üçün etibarsızdır |
Nəzərə alın ki, düzəldilmiş MSISDN LINK Mobility tərəfindən istifadə ediləcək və çatdırılma hesabatlarında geri qaytarılacaq.
Əlavə məlumat üçün LINK Mobility dəstəyi ilə əlaqə saxlayın.
8.2 Simvolların dəyişdirilməsi
Xarakterin dəyişdirilməsi, tələb olunarsa, LINK Mobility dəstəyi ilə aktivləşdirilə bilən əlavə xüsusiyyətdir.
Bu funksiya DCS “GSM” (17) olaraq təyin edildikdə istifadəçi məlumatında (SMS mətni) qeyri-GSM əlifba simvollarını ekvivalent GSM əlifba simvollarına çevirəcək. məsələnample “Seqüência de teste em Português” “Seqüencia de teste em Portugues”ə tərcümə olunacaq.
9. Çatdırılma hesabatları
Xidmət Provayderi, təmin edildiyi təqdirdə, göndərilən MT mesajları üçün SMS mesajlarının çatdırılması hesabatlarını və ya çatdırılma bildirişlərini tələb edə bilər. Bu hesabatlar Operator SMSC-də MT mesajı hədəflənmiş İstehlakçıya çatdırıldıqda və ya silindikdə, məsələn, müddəti bitdikdə və ya nədənsə istiqamətləndirilə bilməyəndə işə salınır.
SMS mesajının yalnız yekun statusu Xidmət Provayderinə bildirilir, yəni çatdırılması və ya silinməsi. Hər MT mesajı üçün yalnız bir hesabat yaradılır. Silinmiş statusla səbəb kodu tətbiq oluna bilər. Bu səbəb kodu SMS mesajının çatdırılmamasının səbəbini müəyyən edir.
Hesabatlar LINK Mobility vasitəsilə yönləndirilir və HTTP protokolundan istifadə edərək Xidmət Provayderinə göndərilir.
Hesabatları almaq üçün Xidmət Provayderi məsələn, həyata keçirməlidirampJava Servlet və ya ASP.NET səhifəsi. Hər ikisi HTTP GET və ya POST sorğularını alır.
Parametrlər
Müraciət aşağıdakı parametrləri ehtiva edir:
| Parametr | Növ | M/O/I* | Defolt Dəyər | Maksimum uzunluq | Təsvir |
| MessageId | simli | M | – | 22 | Bu hesabatın uyğun olduğu MT mesajının mesaj ID-si. |
| Təyinat ünvanı | simli | M | – | 40 | İstehlakçının MSISDN, yəni orijinal MT mesajının təyinat ünvanı. |
| Status Kodu | tam ədəd | M | 1 | Vəziyyət kodu MT mesajının vəziyyətini göstərir. Tətbiq olunan status kodları bunlardır: 0 - Çatdırıldı 2 – Silindi (səbəb kodu tətbiq olunur) |
|
| TimeStamp | simli | M | – | 20 | Çatdırılma hesabatının LINK Mobility tərəfindən nə vaxt qəbul edildiyini göstərən vaxt. Ən vaxt zonasıamp CET və ya CEST (AB üçün müəyyən edilmiş yay vaxtı ilə). Format: yyyyMMdd SS:aa:ss. |
| Operator | simli | M | – | 100 | SMS mesajı göndərilərkən istifadə edilən Operatorun adı və ya SMS mesajı göndərilərkən istifadə edilən hesabın adı. Mövcud Operatorların siyahısı LINK Mobility dəstəyi tərəfindən təmin edilir. |
| Səbəb Kodu | tam ədəd | O | – | 3 | Səbəb kodu mesajın niyə silinmiş statusla bitdiyini göstərir. Müvafiq səbəb kodları bunlardır: 100 - Müddəti bitdi 101 - rədd edildi 102 - Format xətası 103 - Digər səhv 110 – Abunəçi naməlum 111 - Abunəçi qadağandır 112 – Abunəçi təmin edilməyib 113 – Abunəçi mövcud deyil 120 – SMSC xətası 121 - SMSC sıxlığı 122 – SMSC rouminqi 130 - Telefon xətası 131 – Telefonun yaddaşı keçib Davranış Operator inteqrasiyalarına görə dəyişə bilər. |
| OperatorTimeStamp | simli | O | – | 20 | Operatorun SMSC-də hesabatın nə vaxt işə salındığını göstərən vaxt (Operator tərəfindən təmin edilirsə). Ən vaxt zonasıamp CET və ya CEST (AB üçün müəyyən edilmiş yay vaxtı ilə). Format: yyyyMMdd SS:aa:ss. |
| StatusText | simli | O | – | 255 | Operatordan əlavə məlumat üçün yer tutucu, məsələn, statusun/səbəbin aydın mətn təsviri. Davranış Operator inteqrasiyaları ilə fərqlənə bilər. |
| KorrelyasiyaId | simli | O | – | 100 | SendRequest və ya SendTextRequest-də təqdim edilən korrelyasiya identifikatoru. |
| Operator Şəbəkə Kodu | tam ədəd | O | – | 6 | Operatorun Mobil Şəbəkə Kodu (MCC + MNC). |
* M = Məcburi, O = Könüllü, I = Yoxdur.
Xidmət Provayderi LINK Mobility-ni hədəflə təmin etməlidir URL çatdırılma hesabatları üçün (isteğe bağlı olaraq HTTP əsas autentifikasiyası üçün etimadnamələr daxil olmaqla). Xidmət Provayderi hansı HTTP metodundan istifadə edəcəyini seçə bilər:
HTTP POST (tövsiyə olunur)
HTTP GET.
ExampHTTP GET istifadə edərək (uğurla çatdırılıb):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
ExampHTTP GET istifadə edərək (çatdırılmadı, Operator vaxt tədarük etdiamp Tədbir üçün):
Parametrlərdir URL kodladı.
Simvol kodlaması:
Xidmət Provayderi hansı üstünlük verilən simvol kodlaşdırmasından istifadə edəcəyini seçə bilər:
UTF-8 (tövsiyə olunur)
ISO-8859-1.
9.1 Xidmət Təchizatçısının təsdiqi
Xidmət Provayderi hər bir çatdırılma hesabatını təsdiq etməlidir. Təqdimat müsbət ola bilər, yəni çatdırılma hesabatı uğurla alındı və ya mənfi, yəni uğursuz ola bilər.
Nəzərə alın: LINK Mobility-də çatdırılma hesabatları üçün 30 saniyəlik təsdiq üçün oxuma vaxtı var. Vaxt aşımı çatdırılmanın təkrar cəhdinə (yenidən cəhd aktivləşdirilərsə) və ya çatdırılmanın ləğvinə (yenidən cəhd deaktiv edilərsə) səbəb olacaq. Bu o deməkdir ki, Xidmət Provayderi tətbiqi xüsusilə yüksək yüklənmə zamanı sürətli cavab vaxtlarını təmin etməlidir.
Çatdırılma hesabatını emal etməzdən əvvəl LINK Mobility-ə doğru qəbul etməyiniz tövsiyə olunur.
Müsbət və mənfi etiraf qaydası aşağıdakı kimi təsvir edilmişdir:
Müsbət təsdiq, ACK, çatdırılma hesabatı çatdırıldı:
Aşağıdakı XML formatlı məzmunla birlikdə HTTP 200 diapazonunun cavab kodu:
Mənfi təsdiq, NAK, çatdırılma hesabatı çatdırılmayıb:
Müsbət etirafdan başqa hər hansı cavab, məsələnample, mənfi təsdiq hər hansı HTTP xəta kodu və ya aşağıdakı XML məzmunu tərəfindən tetiklenir:
XML məzmunu LINK Mobility təkrar cəhd mexanizmini idarə etmək üçün istifadə edilə bilər. Aktivləşdirildikdə, NAK təkrar cəhdə səbəb olacaq. Yenidən cəhd mexanizmi üçün konfiqurasiya olunmayan Xidmət Provayderləri üçün XML məzmunu isteğe bağlıdır.
Aşağıda HTTP POST sorğusu və cavabı varampXidmət Təchizatçısına çatdırılma hesabatının le:
HTTP Sorğusu:
POST /kontekst/app HTTP/1.1
Məzmun növü: tətbiq / x-www-form-urlkodlanmış; charset=utf-8
Host: server: port
Məzmun uzunluğu: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
HTTP cavabı:
HTTP/1.1 200 OK
Məzmun növü: mətn/düz
9.2 Yenidən cəhd edin
LINK Mobility sistemi uğursuz, yəni qəbul edilməyən çatdırılma hesabatı çatdırılması üçün təkrar cəhdlər edə bilər. Xidmət Provayderi üstünlük verilən təkrar cəhd davranışını seçə bilər:
Yenidən cəhd yoxdur (standart) – qoşulma cəhdi uğursuz olarsa, oxunma vaxtı bitərsə və ya hər hansı HTTP xəta kodu üçün mesaj atılacaq.
Yenidən cəhd edin – hər növ əlaqə problemi, oxunma vaxtı və ya mənfi təsdiq üçün mesaj yenidən göndəriləcək.
NAK üçün təkrar cəhd aktiv olduqda, LINK Mobility-dən təkrar cəhd cəhdi yaradan hansı ssenariləri və təkrar cəhdin necə işlədiyini anlamaq vacibdir. Hər bir Xidmət Provayderinin öz təkrar cəhd növbəsi var, burada mesajlar mesaj vaxtına uyğun olaraq sıralanıramp. Xidmət Provayderinə çatdırılan mesajların fərdi sırasına zəmanət verilməsə də, Link Mobility həmişə köhnə mesajları çatdırmağa çalışır. Mesajların təkrar cəhd növbəsindən silinməsinin əsas səbəbi iki səbəbdən biridir: ya TTL mesajının vaxtı bitir, ya da (nəzəri olaraq) təkrar cəhd növbəsi dolur. TTL Operatordan və hesabdan asılıdır, yəni Operatordan və ya mesaj növündən asılı olaraq dəyişə bilər, məsələn, premium SMS və ya standart tarif SMS mesajı.
Yenidən cəhd aktivləşdirilən Xidmət Provayderləri mesajın artıq qəbul edilmədiyini təmin etmək üçün MT mesajının unikal ID-sini yoxlamalıdırlar.
Çatdırılma hesabatının işlənməsi zamanı xəta baş verdikdə Xidmət Təchizatçısının bu sadə qaydalara riayət etməsi vacibdir, əgər xətanın səbəbi aşağıdakılardır: Müvəqqəti, məsələn, verilənlər bazası mövcud deyil, NAK qaytarılmalıdır. LINK Mobility mesajı yenidən göndərəcək.
Daimi və təkrar cəhd cəhdi eyni problemə səbəb ola bilər, ACK qaytarılmalıdır. məsələnample, mesaj düzgün təhlil edilə bilmədiyi və ya gözlənilməz iş vaxtı xətasına səbəb olduqda.
Müvafiq şəkildə hərəkət etmək, çatdırılma hesabatının təkrar göndərilməsi səbəbindən heç bir bloklanmanın və ya ötürmə qabiliyyətinin pisləşməsinə səbəb olmamasını təmin edəcək.
10. İcraya dair göstərişlər
1. Sizin istifadə etmək mümkündür web API-yə sorğu göndərmək üçün brauzer. Bu, heç bir inkişaf aləti olmadan xidmətləri araşdırmağı və qiymətləndirməyi çox asanlaşdırır.
2. Chrome və ya Firefox, JSON kimi bir uzantı ilə birlikdə tövsiyə olunurView olduqca formatlaşdırılmış JSON-u göstərmək üçün.
3. Biz SoapUI-dən POST, Əsas Doğrulamanı sınamaq və xam HTTP sorğu və cavab mesajlarını yoxlamaq üçün istifadə etdik.
4. cURL alət Əsas Doğrulama ilə POST sorğularını təqdim etmək üçün faydalıdır. Bax keçmişampaşağıda.
curl POST \
-H “Məzmun növü: proqram/x-www-form-urlkodlanmış" \
-H “İcazə: Əsas am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–məlumat “təyinat ünvanı=46123456789&messageText=Salam+Dünya%21”
_______________
Fərdiləşdirilmiş Kommunikasiyaların dəyişdirilməsi
Sənədlər / Resurslar
 |
LINK Mobility Tətbiq Bələdçisi REST API SMS [pdf] İstifadəçi təlimatı Mobility Tətbiq Bələdçisi REST API SMS, Mobillik, Tətbiqetmə Bələdçisi REST API SMS, REST API SMS, API SMS, SMS |
