Дастури татбиқи LINK Mobility REST API SMS
LINK Mobility хидматрасониро барои интиқоли паёмҳо, пардохтҳои хурд ва хидматҳои вобаста ба макон таъмин мекунад. Платформа ҳамчун эксвайери мундариҷаи шаффоф, дорои нишони сафед ва роутери транзаксия байни провайдерҳои хидматрасон ва операторҳо амал мекунад.
LINK Mobility API RESTful медиҳад, ки метавонад барои дастрасӣ ба хидматҳои LINK Mobility, ба монанди ирсоли SMS истифода шавад. Ин API тарҳрезӣ шудааст, ки истифодааш осон бошад ва бо ҳама забонҳо ва чаҳорчӯбаҳои муосир мувофиқ бошад. Бо истифода аз забони интихобкардаи шумо, барномаи шумо метавонад Link Mobility REST API-ро барои татбиқи тавонмандиҳои паёмнависӣ ва пардохт истифода барад.
© LINK Mobility, 10 марти соли 2021
Маълумоти ҳуқуқӣ
Маълумоте, ки дар ин ҳуҷҷат оварда шудааст, моликияти ягона ва ҳуқуқи муаллифии Netsize мебошад. Он махфӣ буда, барои истифодаи дақиқи иттилоотӣ пешбинӣ шудааст. Он ҳатмӣ нест ва метавонад бидуни огоҳӣ тағир дода шавад. Ҳама гуна ифшо ё истифодаи беиҷозат ғайриқонунӣ ҳисобида мешавад.
Netsize™ ва linkmobility™ аз ҷониби қонунҳои фаронсавӣ, EEC ва байналмилалии моликияти зеҳнӣ ҳифз карда мешаванд.
Ҳама тамғаҳои дигари иқтибосшуда моликияти ягонаи соҳибони мувофиқ мебошанд.
Ҳеҷ чизи дар ин ҷо мавҷудбуда набояд ҳамчун додани ягон иҷозатнома ё ҳуқуқ таҳти патент, ҳуқуқи муаллифӣ ё тамғаи молии Netsize тафсир карда шавад.
NETSIZE
Société anonyme ё сармояи он 5 478 070 евро
Муҳосираи иҷтимоӣ: 62, хиёбони Эмил Зола92100 Булон – Фаронса
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Доираи ҳуҷҷат
Ин ҳуҷҷат тавсиф мекунад, ки чӣ тавр Провайдери хидматрасон LINK Mobility REST API-ро барои SMS истифода мебарад. Он барои меъморон ва тарроҳони техникӣ, ки хидматҳои Провайдери хидматрасониро амалӣ мекунанд, пешбинӣ шудааст.
1. Истифодаи асосӣ
Ирсоли SMS хеле осон аст. Шумо ба LINK Mobility дархости HTTP мефиристед, ки онро танҳо бо истифода аз a web браузер.
2. Функсионалӣview
Системаи LINK Mobility функсияҳои асосии зеринро барои паёмҳои SMS таъмин мекунад:
Фиристодани SMS паёмҳои қатъшудаи мобилӣ (MT), ба монанди матнӣ ё дуӣ (масалан, WAP Push) ва паёмҳои сатҳи стандартӣ.
Гирифтани ҳисоботи интиқол барои паёмҳои MT пешниҳодшуда.
Гирифтани паёмҳои SMS-и Mobile Originated (MO), мукофотпулӣ ва меъёри стандартӣ.
API-и SMS REST барои фиристодани паёмҳои SMS бо суръати стандартии MT бахшида шудааст.
API ҳама паёмҳои SMS-ро ба таври асинхронӣ мефиристад, ки чунин хусусиятҳоро фаъол мекунад:
"Оташ кунед ва фаромӯш кунед" - Провайдери хидматрасон мехоҳад, ки вақти бештари посухи пешбинишаванда дошта бошад ва намехоҳад, ки натиҷаро аз Оператор интизор шавад.
Функсияи такрорӣ - LINK Mobility паёмро аз нав мефиристад, агар Оператор мушкилоти муваққатӣ дошта бошад.
2.1 Ирсоли паёми SMS
Таъминкунандаи хидматрасонии Netsize Consumer
- Паёми MT фиристед
- Бозгаштан ID-и паём
- Паёми SMS фиристед
- Ҳисоботи интиқолро пешниҳод кунед
- Ҳисоботи интиқолро фиристед
Ҷараёни асосии ирсоли паёмҳои SMS ба таври зерин тавсиф карда мешавад:
Провайдери хидматрасон дархост мекунад, ки тавассути системаи LINK Mobility ба қабулкунанда SMS ирсол кунад.
ID-и паём ба Провайдери хидмат баргардонида мешавад. Ин идентификаторро барои мисол истифода бурдан мумкин аст, ки паёмро бо гузориши интиқоли дуруст мувофиқ созад.
LINK Mobility масирро идора мекунад ва паёми SMS-ро ба истеъмолкунандаи муроҷиатшуда мерасонад.
Ҳисоботи интиқол ба кор андохта мешавад, масалан, вақте ки паёми SMS ба дастгоҳи истеъмолкунанда интиқол дода мешавад.
Ҳисоботи таҳвил ба Провайдери хидматрасон фиристода мешавад. Ҳисобот ҳамон ID-и паёмро дар бар мегирад, ки дар қадами 2 баргардонида шудааст.
Ҷараёни алтернативӣ: Дархости беэътибор
Агар параметрҳои пешниҳодшуда ё маълумоти корбар дар дархост беэътибор бошанд, хато ба Провайдери хидматрасон баргардонида мешавад. Хатогӣ сабаби радкуниро нишон медиҳад ва ҷараён ба охир мерасад. Ягон ID-и паём баргардонида намешавад.
3. Нуқтаи ниҳоӣ
Ба манбаи SMS тавассути роҳ дастрас карда мешавад:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Барои амнияти пайвастшавӣ API LINK Mobility REST танҳо тавассути HTTPS дастрас аст.
Шаҳодатномаи сервери Link Mobility аз ҷониби Thawte Server CA имзо шудааст.
4. Амалиёти
Хидмати SMS амалҳои зеринро пешкаш мекунад:
| Ном | Роҳ |
| Ирсол | /restapi/v1/sms/send |
4.1 Ирсол
Амалиёти ирсол барои фиристодани SMS ба як қабулкунанда истифода мешавад.
Ин амалиёт барои корбарони асосӣ ва пешрафта пешбинӣ шудааст. Дар соддатарин ҳолат, барои расонидани SMS танҳо суроғаи таъинот ва матни паём лозим аст. LINK Mobility Нақшаи рамзгузории маълумотро муайян мекунад ва дар ҳолати зарурӣ пайвастагии автоматии паёмро ба қисмҳои зиёди паём иҷро мекунад.
Барои истифодаи пешрафта, Провайдери хидматрасон метавонад параметрҳои ихтиёриро барои назорати умумии форматкунии паём, аз ҷумла сарлавҳаи маълумоти корбар истифода барад.
Провайдери хидматрасон метавонад паёмҳои муттаҳид фиристад, аммо омодасозии маълумоти корбар ва сарлавҳаи додаҳои корбар бояд аз ҷониби Провайдери хидматрасон анҷом дода шавад ва паём бояд тавассути дархостҳои ирсоли сершумор ба сӯи LINK Mobility фиристода шавад.
5. Аутентификатсия
Номи корбар ва парол дар ҳар як дархост бо истифода аз схемаи аслии HTTP тасдиқ карда мешавад.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Маълумоти эътимоднома дар сарлавҳаи Авторизатсия дар дархости HTTP фиристода мешавад. Муштарӣ майдони сарлавҳаро тавре месозад, ки дар ин ҷо тавсиф шудааст:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Барои мисолample, агар номи корбар Ҷон бошад ва changeme парол бошад, сарлавҳаи авторизатсия дар натиҷа ин аст:
Авторизатсия: Basic am9objpjaGFuZ2VtZSA =
Ҳамчун бозгашти бозгашт номи корбар ва паролро метавон ҳамчун параметрҳои дархост пешниҳод кард. Ин танҳо барои муштариёне тавсия мешавад, ки Auth Basic -ро дастгирӣ намекунанд.
6. Пешниҳоди дархост
6.1 Сатри дархост
Параметрҳои дархост ҳамчун сатри дархост пешниҳод карда мешаванд, ки дорои ҷуфтҳои ном/арзиш мебошанд. Сатри дархост бо истифода аз рамзгузории фоиз рамзгузорӣ карда мешавад (URL рамзгузорӣ).
http://www.w3schools.com/tags/ref_urlencode.asp
Барои мисолample, Салом Ҷаҳон! ҳамчун Hello+World%21 рамзгузорӣ шудааст.
6.2 Параметрҳои дархости ҳатмӣ
| Ном | Дарозии максималӣ | Тавсифи |
| Суроғаи таъинот | 40 | MSISDN, ки паёми SMS бояд ба он фиристода шавад, аз рамзи кишвар сар карда. Мисолampсуроға: 46123456789. Барои баъзе бозорҳо (дар он ҷое, ки MSISDN-и истеъмолкунанда бояд печида бошад) ин арзиш инчунин метавонад тахаллуси алифбои рақамӣ бошад, ки бо пешванди “#” гузошта шудааст. |
| паёми матн | 1600 | Мазмуни паёми SMS. |
6.3 Параметрҳои дархости ихтиёрӣ (барои истифодаи пешрафта)
| Ном | Дарозии максималӣ | Тавсифи |
| Суроғаи аслӣ | 16 | Суроғаи аслии SMS паёми содиротӣ. Навъи суроғаи аслӣ бо параметри originalatorTON муайян карда мешавад. Рақами кӯтоҳ дарозии ҳадди аксар 16 аст. Ирсолкунандаи рақами алфавӣ бо алифбои пешфарзии GSM бо дарозии ҳадди аксар 11 аломат маҳдуд аст. Дарозии максималии ирсолкунандаи MSISDN 15 аст (бо истифода аз ҳамон формат бо унсури destinationAddress). Ҳангоми аз ҷониби система интихоб кардани Address ва originatingTON мумкин нест. Ин функсия аз бозор ва конфигуратсия вобаста аст. Рафтор бо ҳамгироии Оператор метавонад фарқ кунад. |
| ташаббускорТОН | 1 | Навъи рақами суроғаи аслӣ (ТОН): 0 – рақами кӯтоҳ 1 - Алфа рақамӣ (дарозии ҳадди аксар 11) 2 - MSISDN Ҳангоми интихоб кардани Address ва originatingTON аз ҷониби система метавон онро сарфи назар кард. Ин функсия ба бозор ва конфигуратсия вобаста аст. Рафтор бо ҳамгироии Оператор метавонад фарқ кунад. |
| userDataHeader | 280 | Сарлавҳаи маълумотҳои корбар дар якҷоягӣ бо Маълумоти корбар метавонад то 140, яъне 280 ҳангоми рамзгузории шонздаҳӣ, октетҳо дошта бошад. Ин параметр ҳамеша шонздаҳӣ-рамзгузорӣ шудааст. |
| DCS | 3 | Схемаи рамзгузории маълумот. Рафтор бо ҳамгироии Оператор метавонад фарқ кунад. |
| PID | 3 | ID протокол. Рафтор бо ҳамгироии Оператор метавонад фарқ кунад. |
| NisbiValidityTime | 6 | Вақти нисбии эътибор бо сонияҳо (нисбат ба вақти пешниҳод ба LINK Mobility). Арзиши максималӣ 604800 (7 рӯз) ва пешфарз 48 соат аст. Рафтор бо ҳамгироии Оператор метавонад фарқ кунад. |
| вақти расондан | 20 | Вақти охиринamp вақте ки паёми SMS бояд расонида шавад (вақти расонидани таъхир). Ба қисмати формати вақт нигаред. |
| statusReport Парчамҳо | 1 | Пешниҳоди дархости гузориш: 0 - Ҳисоботи интиқол нест (пешфарз) 1 - Ҳисоботи интиқол дархост карда мешавад 9 – Ҳисоботи интиқоли сервер дархост карда мешавад (LINK Mobility гузоришро ба Провайдери хидматрасон намефиристад, балки онро дар гузоришҳо ва ғайра дастрас мекунад) |
| campaignName | 50 | Муомилоти LINK Mobility инҳоянд tagбо ин ном. Он барои гурӯҳбандии транзаксияҳо дар гузоришҳои Link Mobility истифода мешавад. |
| maxConcatenatedMessages | 1 | Қимат аз 1 то 10, ки муайян мекунад, ки чанд паёми муттаҳидшуда иҷозат дода мешавад. Пешфарз 3 аст. |
| коррелятсияId | 100 | Шаҳодатномаи аз ҷониби провайдери хидматрасон пешниҳодшуда, ки дар Ҳисобот оид ба таҳвил инъикос карда мешавад. |
| номи корбар | 100 | Ҳамчун алтернатива ба HTTP аслӣ тасдиқ карда шудааст. |
| парол | 100 | Ҳамчун алтернатива ба HTTP аслӣ тасдиқ карда шудааст. |
6.4 Усулҳои дархости HTTP
Барои ҳамоҳангсозии ҳадди аксар, API ҳам усулҳои дархости HTTP GET ва POST -ро дастгирӣ мекунад. Ягон усулҳои дигари HTTP иҷозат дода намешавад.
6.4.1 Гирифтан
Сатри дархости рамзгузоришуда ба URL.
ГИРЕД
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Салом+Ҷаҳон%21
Авторизатсия: Basic am9objpjaGFuZ2VtZSA =
6.4.2 ПОСТ
Сатри дархости рамзгузоришуда дар матни паёми дархости HTTP пешниҳод карда мешавад. Content-Type ин барнома/x-www-form- астurlрамзгузорӣ шудааст.
ПОСТ https://europe.ipx.com/restapi/v1/sms/send
Мизбон: europe.ipx.com
Намуди мундариҷа: application / x-www-form-urlрамзгузорӣ шудааст
Авторизатсия: Basic am9objpjaGFuZ2VtZSA =
Дарозии мундариҷа: 57
destinationAddress=46123456789&messageText=Салом+Ҷаҳон%21
6.5 Сана ва вақт
Параметрҳо дар REST API, ки сана ва вақтро намояндагӣ мекунанд, ҳамеша дар минтақаи вақти UTC (Вақти ҳамоҳангшудаи универсалӣ) мебошанд. Вақтсанҷamps ҳамчун сатр бо ин формати дақиқ муаррифӣ карда мешаванд:
2017-04-25T23:20:50Z
Ин 20 дақиқаю 50 сония пас аз соати 23-и 25 апрели соли 2017 дар UTC аст.
7. Паёми ҷавобӣ
Пас аз қабул ва тафсири паёми дархост, API бо паёми посухи HTTP посух медиҳад.
7.1 Рамзи ҳолати HTTP
REST API ҳамеша рамзи ҳолати HTTP 200 OK -ро барои дархостҳои коркардшуда бармегардонад. Ҷисми паём дорои параметри ҷавоби Код мебошад, ки барои муайян кардани натиҷаи дақиқ истифода мешавад.
7.2 Матни паём
Ҷисми паём аз JSON иборат аст, ки натиҷаи дархостро тавсиф мекунад.
http://json.org/
Link Mobility JSON ба дастури услуби Google JSON мувофиқат мекунад.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Параметрҳои вокуниш
| Ном | Дарозии максималӣ | Тавсифи |
| Коди ҷавоб | 3 | 0 транзаксияи муваффақро нишон медиҳад. |
| паёми ҷавобӣ | 255 | Тавсифи матнии посух, масалан, матни хато. |
| вақтamp | 20 | Сана ва вақт, ки LINK Mobility дархостро коркард кард. (Ба қисмати формати сана/вақт нигаред). |
| traceId | 36 | Муайянкунандаи дохилии Link Mobility. Барои дастгирӣ ва ҳалли мушкилот истифода мешавад. |
| ID-и паём | 10 х 36 | Маҷмӯи ID-ҳои беназири паёми LINK Mobility барои ҳар як паёми муваффақ (идентификатсияи паёмҳои сершумор ҳангоми пайваст кардани паём баргардонида мешаванд). Дар сурати ноком шудан. |
7.4 Мисолampҷавобҳо
Муваффакият
HTTP/1.1 200 Хуб
Навъи мундариҷа: application/json
Дарозии мундариҷа: 144
Сана: Се, 15 сентябр 2016 13:20:31 ЗГ
{"responseCode":0,"responseMessage":"Муваффақият","timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Дар ин ҷо ҳамон JSON барои хондан формат карда шудааст:
{
"Коди ҷавоб": 0,
"паёми ҷавобӣ":"Муваффақият",
"вақтamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"ID-и паём":[“1-4850879008”] }
Нокомӣ
HTTP/1.1 200 Хуб
Навъи мундариҷа: application/json
Дарозии мундариҷа: 148
Сана: Се, 15 сентябр 2016 13:20:31 ЗГ
{“responseCode”:1,”responseMessage”:” Воридшавӣ нодуруст ё истифодаи беиҷозати API”,”timeestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Муваффакият
HTTP/1.1 200 Хуб
Навъи мундариҷа: application/json
Дарозии мундариҷа: 144
Сана: Се, 15 сентябр 2016 13:20:31 ЗГ
{"responseCode":0,"responseMessage":"Муваффақият","timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Дар ин ҷо ҳамон JSON барои хондан формат карда шудааст:
{
"Коди ҷавоб": 0,
"паёми ҷавобӣ":"Муваффақият",
"вақтamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"ID-и паём":[“1-4850879008”] }
Нокомӣ
HTTP/1.1 200 Хуб
Навъи мундариҷа: application/json
Дарозии мундариҷа: 148
Сана: Се, 15 сентябр 2016 13:20:31 ЗГ
{“responseCode”:1,”responseMessage”:” Воридшавӣ нодуруст ё истифодаи беиҷозати API”,”timeestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Рамзҳои ҷавоб
Рамзҳои ҷавобии зеринро дар ҷавоби ирсол баргардонидан мумкин аст:
| Кодекс | Матн | Тавсифи |
| 0 | Муваффакият | Бомуваффакият ичро карда шуд. |
| 1 | Воридшавӣ нодуруст ё истифодаи беиҷозати API | Номи корбар ё парол нодуруст ё провайдери хидматрасон аз ҷониби LINK Mobility манъ карда шудааст. |
| 2 | Истеъмолкунанда аз ҷониби Link Mobility баста шудааст | Истеъмолкунанда аз ҷониби LINK Mobility баста шудааст. |
| 3 | Амалиёт аз ҷониби LINK Mobility таъмин карда намешавад | Амалиёт барои Провайдери хидматрасон баста шудааст. |
| 4 | Истеъмолкунанда ба LINK Mobility номаълум аст | Истеъмолкунанда ба LINK Mobility маълум нест. Ё агар дар дархост тахаллус истифода шуда бошад; тахаллус ёфт нашуд. |
| 5 | Истеъмолкунанда ин хидматро дар LINK Mobility масдуд кардааст | Истеъмолкунанда ин хидматро дар LINK Mobility масдуд кардааст. |
| 6 | Суроғаи аслӣ дастгирӣ намешавад | Суроғаи аслӣ дастгирӣ намешавад. |
| 7 | Суроғаи аслии Алфа аз ҷониби ҳисоб дастгирӣ намешавад | Суроғаи сарчашмаи алфа аз ҷониби ҳисоб дастгирӣ намешавад. |
| 8 | Суроғаи аслии MSISDN дастгирӣ намешавад | Суроғаи аслии MSISDN дастгирӣ намешавад. |
| 9 | GSM васеъшуда дастгирӣ намешавад | GSM васеъшуда дастгирӣ намешавад. |
| 10 | Юникод дастгирӣ намешавад | Юникод дастгирӣ намешавад. |
| 11 | Ҳисоботи вазъ дастгирӣ намешавад | Ҳисоботи вазъ дастгирӣ намешавад. |
| 12 | Қобилияти зарурӣ дастгирӣ намешавад | Имконияти зарурӣ (ба ғайр аз гуфтаҳои боло) барои фиристодани паём дастгирӣ намешавад. |
| 13 | Сатҳи ҳадди ниҳоии провайдери мундариҷа аз ҳад зиёд аст | Провайдери хидматрасон SMS паёмҳоро ба LINK Mobility хеле зуд мефиристад. |
| 14 | Протоколи ID аз ҷониби ҳисоб дастгирӣ намешавад | ID Protocol дастгирӣ намешавад. |
| 15 | Ҳадди пайвастшавии паёмҳо аз ҳад гузашт | Миқдори паёмҳои пайвастшуда аз шумораи максималии дархостшуда зиёд аст. |
| 16 | Паёмро интиқол додан ғайриимкон аст. | LINK Mobility натавонист паёмро масир кунад. |
| 17 | Мӯҳлати манъшуда | Дар давоми вақт фиристодани паём иҷозат дода намешавад |
| 18 | Бақияи хеле кам дар ҳисоби провайдери хидматрасон | Провайдери хадамот бо сабаби тавозуни хеле кам баста шудааст |
| 50 | Муваффақияти қисман | Муваффақияти қисман ҳангоми фиристодани паёми SMS ба чанд қабулкунанда. |
| 99 | Хатои Дохилии Сервер | Дигар хатогии Link Mobility, барои маълумоти бештар бо дастгирии LINK Mobility тамос гиред. |
| 100 | Суроғаи таъинот нодуруст | Суроғаи таъинот (MSISDN ё тахаллус) нодуруст аст. |
| 102 | ID беэътибор истинод (пайванд) | ID-и истинод беэътибор аст, шояд ID-и истинод аллакай истифода шудааст, хеле кӯҳна ё номаълум. |
| 103 | Номи ҳисоб нодуруст | Номи ҳисоб нодуруст аст. |
| 105 | Мета-маълумоти хидмати нодуруст | Маълумоти мета хидматӣ нодуруст аст. |
| 106 | Суроғаи аслӣ нодуруст | Суроғаи аслӣ нодуруст аст. |
| 107 | Суроғаи ибтидоии алифбои рақамӣ нодуруст | Суроғаи ибтидоии алифбои рақамӣ нодуруст аст. |
| 108 | Мӯҳлати эътибори беэътибор | Мӯҳлати эътибор беэътибор аст. |
| 109 | Вақти интиқол нодуруст | Мӯҳлати интиқол нодуруст аст. |
| 110 | Мундариҷаи паём/маълумоти корбар нодуруст | Маълумоти корбар, яъне паёми SMS, беэътибор аст. |
| 111 | Дарозии паём нодуруст | Дарозии паёми SMS нодуруст аст. |
| 112 | Сарлавҳаи маълумоти корбар нодуруст | Сарлавҳаи маълумоти корбар нодуруст аст. |
| 113 | Нақшаи рамзгузории додаҳо нодуруст | DCS беэътибор аст. |
| 114 | ID протоколи нодуруст | PID беэътибор аст. |
| 115 | Парчамҳои гузориши ҳолати беэътибор | Парчамҳои гузориши вазъият беэътиборанд. |
| 116 | ТОН беэътибор аст | Оғозгари TON беэътибор аст. |
| 117 | Беэътибор вampноми аин | вampноми aign нодуруст аст. |
| 120 | Маҳдудият барои шумораи максималии паёмҳои пайвастшуда беэътибор аст | Шумораи максималии паёмҳои муттаҳидшуда беэътибор аст. |
| 121 | Суроғаи аслии msisdn нодуруст | Суроғаи аслии MSISDN нодуруст аст. |
| 122 | ID коррелятсияи нодуруст | ID-и коррелятсия нодуруст аст. |
8. Хусусиятҳои ихтиёрӣ
8.1 Ислоҳи MSISDN
Ислоҳи MSISDN як хусусияти ихтиёрист, ки дар сурати дархост тавассути дастгирии LINK Mobility фаъол карда мешавад.
Ин хусусият суроғаҳои таъинотро ислоҳ мекунад ва онҳоро ба формати лозимии E.164 мувофиқ мекунад. Илова бар ислоҳи формат, система метавонад инчунин функсияҳои мушаххаси бозорро иҷро кунад, ба монанди тарҷумаи рақамҳои байналмилалии фаронсавӣ барои ислоҳи рақамҳои DOM-TOM (départements et territoires d'outre-mer) дар ҳолати имконпазир.
Дар зер як қатор собиқ ҳастандampислоҳҳо:
| Суроғаи таъиноти пешниҳодшуда | Суроғаи таъиноти ислоҳшуда |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445ааа | 46702233445 |
| 336005199999 | 2626005199999 (Рақами фаронсавӣ ба рақами DOM-TOM тарҷума шудааст) |
Илова бар ин, имконпазир аст, ки рақамҳои телефонии миллӣ барои бозори интихобшуда иҷозат дода шаванд. Вақте ки ин хусусият фаъол аст, ҳама рақамҳои байналмилалӣ барои бозорҳои дигар бояд бо аломати ибтидоии `+' фиристода шаванд, то онҳоро аз бозори интихобшуда фарқ кунанд.
Дар зер якчанд собиқampислоҳҳое, ки ҳангоми истифодаи Шветсия (рамзи кишвар 46) ҳамчун бозори пешфарз барои рақамҳои миллӣ анҷом дода шудаанд.
| Суроғаи таъиноти пешниҳодшуда | Суроғаи таъиноти ислоҳшуда |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Беэътибор аст, зеро аломати '+' нест |
Дар хотир доред, ки MSISDN-и ислоҳшуда аз ҷониби LINK Mobility истифода мешавад ва он дар гузоришҳои таҳвил баргардонида мешавад.
Лутфан, барои маълумоти бештар бо дастгирии LINK Mobility тамос гиред.
8.2 Иваз кардани аломат
Иваз кардани аломат хусусияти ихтиёрист, ки агар дархост шавад, онро дастгирии LINK Mobility фаъол кардан мумкин аст.
Ин хусусият аломатҳои алифбои ғайри GSM-ро дар маълумоти корбар (матни SMS) ба аломатҳои алифбои GSM муодил тарҷума мекунад, вақте ки DCS ба "GSM" (17) таъин карда шудааст. Барои мисолample "Seqüência de teste em Português" ба "Seqüencia de teste em Portugues" тарҷума карда мешавад.
9. Ҳисобот оид ба таҳвил
Провайдери хадамот метавонад, агар таъмин бошад, ҳисоботи интиқоли паёми SMS ё огоҳиномаҳои интиқолро барои паёмҳои МТ ирсолшуда дархост кунад. Ин гузоришҳо дар Оператори SMSC вақте оғоз мешаванд, ки паёми MT ё ба Истеъмолкунандаи мақсаднок расонида мешавад ё нест карда мешавад, масалан, мӯҳлати мӯҳлат гузаштааст ё бо ягон сабаб масир нест.
Танҳо ҳолати ниҳоии паёми SMS ба Провайдери хидматрасон хабар дода мешавад, яъне интиқол ё нест карда шудааст. Дар як паёми MT танҳо як гузориш тавлид мешавад. Бо ҳолати ҳазфшуда, рамзи сабаб метавонад татбиқ шавад. Ин рамзи сабаб сабаби нарасидани паёми SMS-ро муайян мекунад.
Ҳисоботҳо тавассути LINK Mobility интиқол дода мешаванд ва бо истифода аз протоколи HTTP ба Провайдери хидматрасон фиристода мешаванд.
Барои гирифтани гузоришҳо, Провайдери хидматрасон бояд барои мисол иҷро кунадampJava Servlet ё саҳифаи ASP.NET. Ҳарду дархостҳои HTTP GET ё POST мегиранд.
Параметрҳо
Дархост параметрҳои зеринро дар бар мегирад:
| Параметр | Навъи | M/O/I* | Арзиши пешфарз | Дарозии максималӣ | Тавсифи |
| MessageId | сатр | M | – | 22 | ID-и паёми МТ, ки ин гузориш ба он мувофиқат мекунад. |
| Суроғаи таъинот | сатр | M | – | 40 | MSISDN-и истеъмолкунанда, яъне суроғаи таъиноти паёми аслии MT. |
| Рамзи Статус | бутун | M | 1 | Рамзи Статус ҳолати паёми МТ-ро нишон медиҳад. Рамзҳои ҳолати татбиқшаванда инҳоянд: 0 - расонида шуд 2 - Ҳазфшуда (рамзи сабаб амал мекунад) |
|
| TimeStamp | сатр | M | – | 20 | Вақт нишон медиҳад, ки кай ҳисоботи интиқол аз ҷониби LINK Mobility гирифта шудааст. Минтақаи вақти вақтamp CET ё CEST аст (бо вақти тобистон, ки барои ИА муайян шудааст). Формат: yyyyMMdd HH:mm:ss. |
| Оператор | сатр | M | – | 100 | Номи Оператор ҳангоми ирсоли SMS ё номи ҳисобе, ки ҳангоми ирсоли SMS истифода мешавад. Рӯйхати операторҳои дастрас аз ҷониби дастгирии LINK Mobility пешниҳод карда мешавад. |
| Рамзи сабаб | бутун | O | – | 3 | Рамзи сабаб нишон медиҳад, ки чаро паём дар ҳолати ҳазф шудааст. Рамзҳои сабабҳои татбиқшаванда инҳоянд: 100 - Мӯҳлаташ гузаштааст 101 - рад карда шуд 102 - Хатои формат 103 - Хатогии дигар 110 - Муштарӣ номаълум 111 - Муштарӣ манъ карда шудааст 112 - Муштарӣ таъмин карда нашудааст 113 - Муштарӣ дастрас нест 120 - Нокомии SMSC 121 - бандшавии SMSC 122 - Роуминги SMSC 130 - Хатогии телефон 131 - Хотираи телефони телефонӣ аз ҳад зиёд шуд Рафтор бо ҳамгироии Оператор метавонад фарқ кунад. |
| OperatorTimeStamp | сатр | O | – | 20 | Вақти нишон додани он, ки кай ҳисобот дар SMSC-и Оператор оғоз шудааст (агар аз ҷониби Оператор пешниҳод карда шавад). Минтақаи вақти вақтamp CET ё CEST аст (бо вақти тобистон, ки барои ИА муайян шудааст). Формат: yyyyMMdd HH:mm:ss. |
| Ҳолати Матн | сатр | O | – | 255 | Ҷойгиркунанда барои маълумоти иловагӣ аз Оператор, масалан тавсифи матни равшани вазъият/сабаб. Рафтор бо ҳамгироии Оператор метавонад фарқ кунад. |
| Коррелятсия ID | сатр | O | – | 100 | ID-и коррелятсия дар SendRequest ё SendTextRequest дода шудааст. |
| Рамзи Шабакаи Оператор | бутун | O | – | 6 | Рамзи Шабакаи Мобилӣ (MCC + MNC) Оператор. |
* M = ҳатмӣ, O = ихтиёрӣ, I = сарфи назар.
Провайдери хидматрасон бояд LINK Mobility-ро бо ҳадаф таъмин намояд URL барои гузоришҳои таҳвил (ихтиёрӣ аз ҷумла маълумоти эътимоднома барои тасдиқи асосии HTTP). Провайдери хидматрасон метавонад интихоб кунад, ки кадом усули афзалиятноки HTTP истифода шавад:
HTTP POST (тавсия дода мешавад)
HTTP GET.
Exampбо истифода аз HTTP GET (бомуваффақият расонида шуд):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example бо истифода аз HTTP GET (нарасонд, Оператор вақтро таъмин кардаастamp барои чорабинӣ):
Параметрҳо ҳастанд URL рамзгузорӣ.
Рамзгузории аломат:
Провайдери хидматрасон метавонад интихоб кунад, ки кадом рамзгузории аломатҳои мувофиқро истифода барад:
UTF-8 (тавсия дода мешавад)
ISO-8859-1.
9.1 Тасдиқи провайдери хидматрасон
Провайдери хидматрасон бояд ҳар як ҳисоботи таҳвилро эътироф кунад. Эътироф метавонад мусбат бошад, яъне гузориши интиқол бомуваффақият гирифташуда ё манфӣ, яъне нокомӣ.
Лутфан таваҷҷӯҳ намоед: LINK Mobility мӯҳлати хондан барои тасдиқи 30 сония барои гузоришҳои интиқол дорад. Танаффус кӯшиши такрории интиқолро (агар кӯшиши такрорӣ фаъол бошад) ё бекор кардани интиқолро (агар кӯшиши такрорӣ ғайрифаъол карда бошад) ба вуҷуд меорад. Ин маънои онро дорад, ки барномаи Провайдери хидматрасон бояд вақти вокуниши зудро таъмин кунад, хусусан ҳангоми сарбории баланд.
Тавсия дода мешавад, ки пеш аз коркарди он гузориши интиқолро ба LINK Mobility тасдиқ кунед.
Қоидаи эътирофи мусбат ва манфӣ ба таври зерин тавсиф карда мешавад:
Эътирофоти мусбӣ, ACK, гузориши таҳвил расонида шудааст:
Рамзи посухи диапазони HTTP 200 дар якҷоягӣ бо мундариҷаи форматшудаи XML:
Эътирофоти манфӣ, NAK, гузориши таҳвил дода нашудааст:
Ҳама гуна ҷавоб ба ғайр аз эътирофи мусбӣ, масаланample, эътирофи манфӣ тавассути ҳама гуна рамзи хатои HTTP ё мундариҷаи зерини XML оғоз мешавад:
Мундариҷаи XML метавонад барои идоракунии механизми такрории LINK Mobility истифода шавад. Агар фаъол бошад, NAK кӯшиши такрориро ба вуҷуд меорад. Барои провайдерҳои хидматрасон, ки барои механизми такрорӣ танзим нашудаанд, мундариҷаи XML ихтиёрӣ аст.
Дар зер дархости HTTP POST ва посухи қаблӣ оварда шудаастampҲисоботи интиқол ба Провайдери хидматрасон:
Дархости HTTP:
POST /контекст/барнома HTTP/1.1
Намуди мундариҷа: application / x-www-form-urlрамзгузорӣ шудааст;charset=utf-8
Хост: сервер: порт
Дарозии мундариҷа: xx
MessageId=213123213&Адреси Destination=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Ҷавоби HTTP:
HTTP/1.1 200 Хуб
Навъи мундариҷа: матн / оддӣ
9.2 Боз кӯшиш кунед
Системаи LINK Mobility метавонад кӯшишҳои такрориро барои интиқоли гузориши ноком, яъне эътирофнашуда иҷро кунад. Провайдери хидматрасон метавонад рафтори аз нав кӯшиши мувофиқро интихоб кунад:
Кӯшиши такрорӣ нест (пешфарз) - агар кӯшиши пайвастшавӣ ноком шавад, вақти хондани вақт ё ягон рамзи хатои HTTP, паём партофта мешавад.
Аз нав кӯшиш кунед – паём барои ҳар як намуди мушкилоти пайвастшавӣ, вақти хондан ё тасдиқи манфӣ дубора фиристода мешавад.
Вақте ки кӯшиши дубора барои NAK фаъол карда мешавад, фаҳмидани он, ки кадом сенарияҳое, ки кӯшиши такрориро аз LINK Mobility тавлид мекунанд ва кӯшиши такрорӣ чӣ гуна кор мекунад, муҳим аст. Ҳар як провайдери хидматрасон навбати такрории худро дорад, ки дар он паёмҳо мувофиқи вақти паём тартиб дода мешавандamp. Link Mobility ҳамеша кӯшиш мекунад, ки паёмҳои кӯҳнаро пеш аз ҳама интиқол диҳад, гарчанде ки тартиби инфиродии паёмҳои ба Провайдери хидматрасон расонидашуда кафолат дода намешавад. Сабаби асосии партофтани паёмҳо аз навбати кӯшиши такрорӣ яке аз ду сабаб аст: ё мӯҳлати паёми TTL ба охир мерасад ё (аз ҷиҳати назариявӣ) навбати кӯшиши такрорӣ пур мешавад. TTL аз Оператор ва суратҳисоб вобаста аст, яъне вобаста ба Оператор ва ё навъи паём метавонад фарқ кунад, масалан, SMS-и мукофотӣ ё паёми стандартии SMS.
Провайдерҳои хидматрасон, ки кӯшиши дубора фаъол карда шудаанд, бояд ID-и ягонаи паёми MT-ро тафтиш кунанд, то боварӣ ҳосил кунанд, ки паём аллакай қабул нашудааст.
Барои Провайдери хидматрасон муҳим аст, ки ин қоидаҳои оддиро риоя кунад, вақте ки ҳангоми коркарди ҳисоботи таҳвил хатогӣ рух медиҳад, агар сабаби хатогӣ ин бошад: Муваққатӣ, масалан, пойгоҳи додаҳо дастрас нест, NAK бояд баргардонида шавад. LINK Mobility паёмро дубора мефиристад.
Кӯшиши доимӣ ва такрорӣ эҳтимолан боиси як навъ мушкилот гардад, ACK бояд баргардонида шавад. Барои мисолample, вақте ки паём дуруст таҳлил карда наметавонист ё боиси хатои ғайричашмдошти вақти корӣ гардид.
Андешидани чораҳои дахлдор кафолат медиҳад, ки ҳеҷ гуна басташавӣ ё таназзули интиқол аз сабаби такроран фиристодани гузориши интиқол ба вуҷуд наояд.
10. Маслиҳатҳо оид ба татбиқ
1. Шуморо истифода бурдан мумкин аст web браузер барои фиристодани дархостҳо ба API. Ин омӯхтан ва арзёбии хидматҳоро бе ягон абзори рушд хеле осон мекунад.
2. Chrome ё Firefox якҷоя бо васеъшавӣ ба монанди JSON тавсия карда мешавандView барои намоиш додани JSON-и зебо форматшуда.
3. Мо SoapUI-ро барои санҷиши POST, Authentication Basic ва барои тафтиши дархости хоми HTTP ва паёмҳои посух истифода бурдем.
4. вURL асбоб барои пешниҳоди дархостҳои POST бо аутентификатсияи асосӣ муфид аст. Бубинед, собиқampдар зер.
curl ПОСТ \
-H "Type Content: application/x-www-form-urlрамзгузорӣ шудааст" \
-H “Авторизатсия: Basic am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–маълумоти “Адреси таъинот=46123456789&messageText=Салом+Ҷаҳон%21”
_______________
Табдил додани коммуникатсияҳои фардӣ
Ҳуҷҷатҳо / Сарчашмаҳо
 |
Дастури татбиқи LINK Mobility REST API SMS [pdf] Дастури корбар Дастури татбиқи Mobility REST API SMS, Mobility, Дастури амалӣ REST API SMS, REST API SMS, API SMS, SMS |
