LINK мобилдүүлүктү ишке ашыруу боюнча колдонмо REST API SMS
LINK Mobility билдирүүлөрдү жеткирүү, микро төлөмдөр жана жайгашкан жерге негизделген кызматтар үчүн кызмат көрсөтөт. Платформа Кызмат көрсөтүүчүлөр менен Операторлордун ортосунда ачык-айкын, ак-белгилүү контент эквайер жана транзакция роутер катары иштейт.
LINK Mobility SMS жөнөтүү сыяктуу LINK Mobility кызматтарына кирүү үчүн колдонула турган RESTful API менен камсыз кылат. Бул API колдонууга оңой жана бардык заманбап тилдер жана алкактар менен шайкеш келүү үчүн иштелип чыккан. Сиз тандаган тилди колдонуп, колдонмоңуз күчтүү билдирүүлөрдү жана төлөм мүмкүнчүлүктөрүн ишке ашыруу үчүн Link Mobility REST API колдоно алат
© LINK Mobility, 10-март, 2021-жыл
Юридикалык маалымат
Бул документте берилген маалымат Netsize компаниясынын жалгыз менчиги жана автордук укугу болуп саналат. Бул жашыруун жана катуу маалыматтык колдонуу үчүн арналган. Ал милдеттүү эмес жана эскертүүсүз өзгөртүлүшү мүмкүн. Ар кандай уруксатсыз ачыкка чыгаруу же пайдалануу мыйзамсыз деп эсептелет.
Netsize™ жана linkmobility™ француз, ЕЭК жана эл аралык интеллектуалдык менчик мыйзамдары менен корголот.
Бардык башка соода белгилери алардын тиешелүү ээлеринин гана менчиги болуп саналат.
Бул жерде камтылган эч нерсе Netsize патентине, автордук укукка же соода белгисине ылайык кандайдыр бир лицензия же укук берүү катары чечмеленбеши керек.
NETSIZE
Société анонимдүү же капиталдын баасы 5 478 070 евро
Siège social :62, проспект Эмиль Зола92100 Булон – Франция
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Документтин чөйрөсү
Бул документ Кызмат Провайдеринин SMS үчүн LINK Mobility REST API кантип колдонорун сүрөттөйт. Ал Кызмат Провайдеринин кызматтарын ишке ашырган техникалык архитекторлор жана дизайнерлер үчүн арналган.
1. Негизги колдонуу
SMS жөнөтүү абдан оңой. Сиз LINK Mobility'ке HTTP сурамын жөнөтөсүз, аны жөн гана a аркылуу аткарууга болот web браузер.
2. Functional Overview
LINK Mobility системасы SMS билдирүүлөр үчүн төмөнкү негизги функцияларды камсыз кылат:
Тексттик же бинардык (мисалы, WAP Push) премиум жана стандарттык тарифтик билдирүүлөр сыяктуу Мобилдик токтотулган (MT) SMS билдирүүлөрдү жөнөтүү.
Берилген MT билдирүүлөр үчүн жеткирүү отчетторун алуу.
Mobile Originated (MO) SMS билдирүүлөрүн алуу, премиум жана стандарттык тариф.
SMS REST API стандарттуу МТ SMS билдирүүлөрүн жөнөтүүгө арналган.
API бардык SMS билдирүүлөрүн асинхрондуу түрдө жөнөтүп, төмөнкү функцияларды иштетет:
“Өрт жана унут” – Кызмат Провайдери алдын ала жооп берүү убактысынын көбүрөөк болушун каалайт жана Оператордон жыйынтыкты күтүүнү каалабайт.
Кайра аракет кылуу функциясы – Оператордун убактылуу көйгөйлөрү бар болсо, LINK Mobility билдирүүнү кайра жөнөтөт.
2.1 SMS билдирүү жөнөтүү
Кызмат провайдери Netsize Consumer
- MT билдирүү жөнөтүү
- Кайтаруу билдирүү ID
- SMS билдирүү жөнөтүү
- Жеткирүү отчетун берүү
- Жеткирүү отчетун жөнөтүү
SMS билдирүүлөрдү жөнөтүүнүн негизги агымы төмөнкүчө сүрөттөлөт:
Кызмат Провайдери LINK Mobility системасы аркылуу алуучуга SMS билдирүү жөнөтүү өтүнүчү менен кайрылат.
Кызмат көрсөтүүчүгө билдирүү ID кайтарылат. Бул ID, мисалы, билдирүүнү туура жеткирүү отчету менен салыштыруу үчүн колдонулушу мүмкүн.
LINK Mobility маршрутту башкарат жана даректелген Керектөөчүгө SMS билдирүүнү жеткирет.
Жеткирүү отчету, мисалы, СМС билдирүү Керектөөчүнүн түзмөгүнө жеткирилгенде иштетилет.
Жеткирүү отчету Кызмат көрсөтүүчүгө жөнөтүлөт. Отчет 2-кадамда кайтарылган ошол эле билдирүү идентификаторун камтыйт.
Альтернативдүү агым: Жараксыз өтүнүч
Сурамда берилген параметрлер же колдонуучунун эсептик маалыматтары жараксыз болсо, ката Кызмат Провайдерине кайтарылат. Ката баш тартуунун себебин көрсөтүп, агым аяктайт. Эч кандай билдирүү идентификаторлору кайтарылбайт.
3. Акыркы чекит
SMS ресурсуна жолду колдонуу менен кирүүгө болот:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Туташуу коопсуздугу үчүн LINK Mobility REST API 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=
Колдонуучунун аты менен сырсөздү кайра кайтаруу катары сурамдын параметрлери катары тапшырса болот. Бул негизги аутентификацияны колдобогон кардарлар үчүн гана сунушталат.
6. Өтүнмө берүү
6.1 Сурам саптары
Сурамдын параметрлери аталыш/маани жуптарын камтыган суроо сап катары берилет. Суроо сап Процент коддоосу менен коддолгон (URL коддоо).
http://www.w3schools.com/tags/ref_urlencode.asp
Мисалы үчүнample, Hello World! Hello+World%21 катары коддолгон.
6.2 Сурамдын милдеттүү параметрлери
| аты | Максималдуу узундук | Description |
| destinationAddress | 40 | SMS билдирүү жөнөтүлүшү керек болгон MSISDN, өлкөнүн кодунан баштап. Мисampле: 46123456789. Кээ бир базарлар үчүн (Керектөөчү MSISDN бүдөмүк болушу керек) бул маани "#" префикси менен алфавиттик-сандык лакап ат болушу мүмкүн. |
| messageText | 1600 | SMS билдирүүнүн мазмуну. |
6.3 Кошумча суроо параметрлери (өнүккөн колдонуу үчүн)
| аты | Максималдуу узундук | Description |
| originatingAddress | 16 | Чыгуучу SMS билдирүүнүн баштапкы дареги. Баштапкы даректин түрү originalatorTON параметри менен аныкталат. Кыска сандын максималдуу узундугу 16. Альфа-сандык жөнөтүүчү максималдуу узундугу 11 белгиден турган GSM демейки алфавити менен чектелген. MSISDN жөнөтүүчүнүн максималдуу узундугу 15 (destinationAddress элементи менен бирдей форматты колдонуу менен). Тутум тарабынан originatingAddress жана originatingTON тандалганда өткөрүп жиберүүгө болот. Бул функция рынокко жана конфигурацияга көз каранды. Жүрүм-турум Оператор интеграциясына жараша өзгөрүшү мүмкүн. |
| оригинаторТОН | 1 | Баштапкы даректин номер түрү (ТОН): 0 – кыска сан 1 – Альфа-сан (максималдуу узундук 11) 2 – MSISDN Түзүлгөн дарек жана originatingTON тутум тарабынан тандалып алынганда калтырылышы мүмкүн. Бул функция рынокко жана конфигурацияга көз каранды. Жүрүм-турум Оператор интеграциясына жараша өзгөрүшү мүмкүн. |
| userDataHeader | 280 | Колдонуучунун берилиштеринин аталышы Колдонуучунун берилиштери менен бирге 140ка чейин, башкача айтканда, алты тараптуу коддолгондо 280 октетти камтышы мүмкүн. Бул параметр ар дайым он алтылык коддолгон. |
| DCS | 3 | Маалыматтарды коддоо схемасы. Жүрүм-турум Оператор интеграциясына жараша өзгөрүшү мүмкүн. |
| PID | 3 | Протокол ID. Жүрүм-турум Оператор интеграциясына жараша өзгөрүшү мүмкүн. |
| салыштырмалууValidityTime | 6 | Салыштырмалуу жарактуу мөөнөтү секундалар менен (LINK Mobility тапшыруу убактысына карата). Максималдуу маани 604800 (7 күн) жана демейки 48 саат. Жүрүм-турум Оператор интеграциясына жараша өзгөрүшү мүмкүн. |
| жеткирүү убактысы | 20 | Timestamp SMS билдирүү качан жеткирилиши керек (кечигип жеткирүү убактысы). Дата убакыт форматы бөлүмүн караңыз. |
| statusReportFlags | 1 | Отчеттун өтүнүчүн жеткирүү: 0 – Жеткирүү отчету жок (демейки) 1 – Жеткирүү отчету суралган 9 – Серверди жеткирүү отчету суралды (LINK Mobility отчетту Кызмат Провайдерине жөнөтпөйт, бирок аны отчеттордо жеткиликтүү кылат ж.б.) |
| campaignName | 50 | LINK Mobility транзакциялары болуп саналат tagушул ат менен. Ал Link Mobility отчетторунда транзакцияларды топтоо үчүн колдонулат. |
| maxConcatenatedMessages | 1 | 1 жана 10 ортосундагы маани, канча бириктирилген билдирүүлөргө уруксат берилгенин аныктайт. Демейки 3. |
| correlationId | 100 | Кызмат провайдери тарабынан берилген ID, Жеткирүү отчетунда чагылдырылат. |
| колдонуучунун аты | 100 | HTTP Негизги аутентификациясына альтернатива катары берилген. |
| купуя сөз | 100 | HTTP Негизги аутентификациясына альтернатива катары берилген. |
6.4 HTTP суроо ыкмалары
Максималдуу өз ара аракеттенүү үчүн API HTTP GET жана POST суроо ыкмаларын колдойт. Башка HTTP ыкмаларына жол берилбейт.
6.4.1 GET
Коддолгон суроо сапка тиркелет URL.
GET
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Салам+Дүйнө%21
Авторизация: Basic am9objpjaGFuZ2VtZSA=
6.4.2 POST
Коддолгон сурам сабы HTTP сурамынын билдирүү бөлүгүндө берилет. Content-Type - бул колдонмо/x-www-form-urlкоддолгон.
POST https://europe.ipx.com/restapi/v1/sms/send
Хост: europe.ipx.com
Мазмун түрү: application / x-www-form-urlкоддолгон
Авторизация: Basic am9objpjaGFuZ2VtZSA=
Content-Length: 57
destinationAddress=46123456789&messageText=Салам+Дүйнө%21
6.5 Дата жана убакыт
Дата менен убакытты билдирген REST API'деги параметрлер ар дайым UTC убакыт алкагында болот (Координацияланган универсалдуу убакыт). Timestamps бул так формат менен сап катары көрсөтүлөт:
2017-04-25T23:20:50Z
Бул UTC боюнча 20-жылдын 50-апрелиндеги 23 сааттан кийин 25 мүнөт 2017 секундду билдирет.
7. Жооп билдирүүсү
Сурам билдирүүсүн кабыл алгандан жана чечмелегенден кийин API HTTP жооп билдирүүсү менен жооп берет.
7.1 HTTP статус коду
REST API ар дайым иштетилген суроо-талаптар үчүн HTTP статус кодун 200 OK кайтарат. Кабардын корпусунда так жыйынтыкты аныктоо үчүн колдонулган жооптун коду параметри бар.
7.2 Кабардын негизги бөлүгү
Билдирүү органы суроо-талаптын жыйынтыгын сүрөттөгөн JSONден турат.
http://json.org/
Link Mobility JSON Google JSON Style Guide менен шайкеш келет.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Жооптун параметрлери
| аты | Максималдуу узундук | Description |
| жооп коду | 3 | 0 ийгиликтүү транзакцияны көрсөтөт. |
| жооп билдирүү | 255 | Жооптун тексттик сыпаттамасы, мисалы, ката тексти. |
| убакытamp | 20 | LINK Mobility өтүнүчтү иштеткен күн жана убакыт. (Күн/убакыт формат бөлүмүн караңыз). |
| traceId | 36 | Шилтеме мобилдүүлүктүн ички идентификатору. Колдоо жана көйгөйлөрдү чечүү үчүн колдонулат. |
| messageIDs | 10 x 36 | Ар бир ийгиликтүү билдирүү үчүн LINK Mobility уникалдуу билдирүү идентификаторлорунун массивдери (эгер билдирүү бириктирилген болсо, бир нече билдирүү идентификаторлору кайтарылат). Иштебей калган учурда алынып салынды. |
7.4 Чыгampжооптор
Ийгилик
HTTP/1.1 200 ОК
Мазмун түрү: application/json
Content-Length: 144
Дата: Бш, 15 Сентябр 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Ийгилик”,”timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Бул жерде окулушу үчүн форматталган ошол эле JSON:
{
"жооп коду“:0,
"жооп билдирүү":"Ийгилик",
"убакытamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"messageIDs“:[“1-4850879008”] }
Ийгиликсиздик
HTTP/1.1 200 ОК
Мазмун түрү: application/json
Content-Length: 148
Дата: Бш, 15 Сентябр 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Жараксыз логин же уруксатсыз API колдонуу”,”timeestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Ийгилик
HTTP/1.1 200 ОК
Мазмун түрү: application/json
Content-Length: 144
Дата: Бш, 15 Сентябр 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Ийгилик”,”timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Бул жерде окулушу үчүн форматталган ошол эле JSON:
{
"жооп коду“:0,
"жооп билдирүү":"Ийгилик",
"убакытamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"messageIDs“:[“1-4850879008”] }
Ийгиликсиздик
HTTP/1.1 200 ОК
Мазмун түрү: application/json
Content-Length: 148
Дата: Бш, 15 Сентябр 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Жараксыз логин же уруксатсыз API колдонуу”,”timeestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Жооп коддору
Жөнөтүлгөн жоопто төмөнкү жооп коддору кайтарылышы мүмкүн:
| Code | Текст | Description |
| 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 | Мазмун провайдеринин максималдуу чектөө ылдамдыгы ашып кетти | Кызмат Провайдери LINK Mobility'ге SMS билдирүүлөрдү өтө тез жөнөтүүдө. |
| 14 | Протокол ID каттоо эсеби тарабынан колдоого алынбайт | Протокол ID колдоого алынбайт. |
| 15 | Билдирүүнү бириктирүү чегинен ашты | Бириктирилген билдирүүлөрдүн саны суралган максималдуу сандан ашып кетти. |
| 16 | Билдирүү багыттоо мүмкүн эмес. | LINK Mobility билдирүүнү багыттай алган жок. |
| 17 | Тыюу салынган мөөнөт | Убакыттын ичинде билдирүү жөнөтүүгө жол берилбейт |
| 18 | Кызмат көрсөтүүчүнүн эсебинде баланс өтө аз | Баланс өтө аз болгондуктан, кызмат көрсөтүүчү бөгөттөлгөн |
| 50 | Жарым-жартылай ийгилик | Бир нече алуучуларга SMS билдирүү жөнөтүүдө жарым-жартылай ийгилик. |
| 99 | Ички сервер катасы | Башка Link Mobility катасы, көбүрөөк маалымат алуу үчүн LINK Mobility колдоо бөлүмүнө кайрылыңыз. |
| 100 | Жараксыз бара турган дарек | Көздөгөн дарек (MSISDN же лакап ат) жараксыз. |
| 102 | Жараксыз шилтемеленген (шилтемеленген) ID | Маалымдама идентификатору жараксыз, балким, маалымдама ID мурунтан эле колдонулган, өтө эски же белгисиз. |
| 103 | Каттоо эсебинин аты жараксыз | Каттоо эсебинин аты жараксыз. |
| 105 | Кызматтын мета дайындары жараксыз | Кызматтын мета дайындары жараксыз. |
| 106 | Жараксыз баштапкы дарек | Баштапкы дарек жараксыз. |
| 107 | Жараксыз тамга-сандык баштапкы дарек | Алфавит-сандан турган дарек жараксыз. |
| 108 | Жараксыз убакыт | Жарактуулук мөөнөтү жараксыз. |
| 109 | Жараксыз жеткирүү убактысы | Жеткирүү убактысы жараксыз. |
| 110 | Жараксыз билдирүү мазмуну/колдонуучунун маалыматы | Колдонуучунун маалыматы, башкача айтканда, SMS билдирүүсү жараксыз. |
| 111 | Билдирүүнүн узундугу жараксыз | SMS билдирүүнүн узундугу жараксыз. |
| 112 | Колдонуучунун маалыматынын баш аты жараксыз | Колдонуучунун маалыматынын аталышы жараксыз. |
| 113 | Маалыматтарды коддоо схемасы жараксыз | DCS жараксыз. |
| 114 | Жараксыз протокол ID | PID жараксыз. |
| 115 | Жараксыз абал отчетунун желектери | Статус отчетунун желектери жараксыз. |
| 116 | Жараксыз TON | Түзүүчү TON жараксыз. |
| 117 | Жараксыз campаты | вampaign аты жараксыз. |
| 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 колдоосу менен иштете алат.
Бул функция DCS "GSM" (17) деп коюлганда, колдонуучунун маалыматындагы (SMS тексти) GSM эмес алфавиттик белгилерди эквиваленттүү GSM алфавиттик белгилерге которот. Мисалы үчүнample “Seqüência de teste em Português” “Seqüencia de teste em Portugues” деп которулат.
9. Жеткирүү отчеттору
Кызмат Провайдер, эгерде камсыз кылынса, SMS билдирүүлөрдү жеткирүү отчетторун же жөнөтүлгөн МТ билдирүүлөрү үчүн жеткирүү эскертмелерин сурай алат. Бул отчеттор SMSC Операторунда МТ билдирүүсү максаттуу Керектөөчүгө жеткирилгенде же өчүрүлгөндө, мис., мөөнөтү бүткөндө же кандайдыр бир себептерден улам багыттоого мүмкүн болбогондо пайда болот.
Кызмат көрсөтүүчүгө SMS билдирүүнүн акыркы абалы гана билдирилет, б.а. жеткирилген же өчүрүлгөн. MT билдирүү үчүн бир гана отчет түзүлөт. Жок кылынган статус менен, себеп коду колдонулушу мүмкүн. Бул себеп коду SMS-билдирүү жеткирилбей калган себебин көрсөтөт.
Отчеттор LINK Mobility аркылуу багытталат жана HTTP протоколу аркылуу Кызмат Провайдерине жөнөтүлөт.
Отчетторду алуу үчүн Кызмат Провайдер эксampJava Servlet же ASP.NET баракчасы. Экөө тең HTTP GET же POST сурамдарын алышат.
Параметрлер
Сурам төмөнкү параметрлерди камтыйт:
| Параметр | Type | M/O/I* | Демейки маани | Максималдуу узундук | Description |
| MessageId | сап | M | – | 22 | Бул отчет дал келген МТ кабарынын ID ID. |
| DestinationAddress | сап | M | – | 40 | Керектөөчүнүн MSISDN, башкача айтканда, баштапкы MT билдирүүнүн көздөгөн дареги. |
| StatusCode | бүтүн сан | M | 1 | Статус коду МТ кабарынын абалын көрсөтөт. Тиешелүү статус коддору: 0 - жеткирилди 2 – Жок кылынды (себеп коду колдонулат) |
|
| TimeStamp | сап | M | – | 20 | Жеткирүү отчету LINK Mobility тарабынан качан кабыл алынганын көрсөткөн убакыт. Убакыт алкагыamp CET же CEST (ЕБ үчүн аныкталган жайкы убакыт менен). Формат: yyyyMMdd СС:мм:сс. |
| Оператор | сап | M | – | 100 | SMS билдирүүнү жөнөтүүдө колдонулган Оператордун аты же SMS билдирүүнү жөнөтүүдө колдонулган эсептин аты. Жеткиликтүү Операторлордун тизмеси LINK Mobility колдоо кызматы тарабынан берилген. |
| ReasonCode | бүтүн сан | 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 СС:мм:сс. |
| StatusText | сап | O | – | 255 | Оператордон кошумча маалымат алуу үчүн толтургуч, мисалы, абалдын/себептин ачык-айкын тексттик сүрөттөмөсү. Жүрүм-турум Оператор интеграциясына жараша өзгөрүшү мүмкүн. |
| CorrelationId | сап | O | – | 100 | SendRequest же SendTextRequest ичинде берилген корреляция ID. |
| OperatorNetworkCode | бүтүн сан | O | – | 6 | Оператордун Мобилдик тармак коду (MCC + MNC). |
* M = Милдеттүү, O = Кошумча, I = Эңил.
Кызмат Провайдери максаттуу LINK Mobility менен камсыз кылууга тийиш URL жеткирүү отчеттору үчүн (милдеттүү эмес, HTTP негизги аныктыгын текшерүү үчүн эсептик дайындарды камтыйт). Кызмат Провайдер кайсы HTTP ыкмасын колдонууну тандай алат:
HTTP POST (сунушталат)
HTTP GET.
ExampHTTP 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 encodedi.
Символду коддоо:
Кызмат көрсөтүүчү кайсы символдук коддоону колдонууну тандай алат:
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&DestinationAddress=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 билдирүү.
Кайталап аракет иштетилген Кызмат Провайдерлери МТ билдирүүсүнүн уникалдуу идентификаторун текшерип, кабардын алына электигин ырасташы керек.
Жеткирүү отчетун иштеп чыгуу учурунда ката пайда болгондо, Кызмат Провайдеринин ушул жөнөкөй эрежелерди сактоосу маанилүү, эгерде катанын себеби: Убактылуу, мисалы, маалымат базасы жок болсо, NAK кайтарылып берилиши керек. LINK Mobility билдирүүнү кайра жөнөтөт.
Туруктуу жана кайталап аракет кылуу бир эле көйгөйдү жаратышы мүмкүн, ACK кайтарылышы керек. Мисалы үчүнample, качан билдирүү туура талдоо мүмкүн эмес же күтүлбөгөн аткаруу катасы себеп болгон.
Тиешелүү иш-аракет жеткирүү отчету кайра-кайра жөнөтүлгөндүктөн эч кандай бөгөт коюу же өткөрүү жөндөмдүүлүгүнүн начарлашын камсыздайт.
10. Ишке ашыруу боюнча кеңештер
1. Сиздин колдонууга болот web API'ге суроо-талаптарды тапшыруу үчүн браузер. Бул эч кандай иштеп чыгуу куралдарысыз кызматтарды изилдөө жана баалоону абдан жеңилдетет.
2. Chrome же Firefox JSON сыяктуу кеңейтүү менен бирге сунушталатView жакшы форматталган JSON көрсөтүү үчүн.
3. Биз SoapUIди POST, Негизги аутентификацияны сыноо жана чийки HTTP суроо-талаптарын жана жооп билдирүүлөрүн текшерүү үчүн колдондук.
4. вURL курал Негизги аутентификация менен POST сурамдарын берүү үчүн пайдалуу. Эксampле төмөндө.
curl ПОСТ \
-H "Мазмун түрү: колдонмо/x-www-form-urlкоддолгон" \
-H “Авторизация: Негизги am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–маалымат “дестинация дареги=46123456789&messageText=Hello+World%21”
_______________
Жекелештирилген коммуникацияларды өзгөртүү
Документтер / Ресурстар
 |
LINK мобилдүүлүктү ишке ашыруу боюнча колдонмо REST API SMS [pdf] Колдонуучунун колдонмосу Mobility ишке ашыруу боюнча колдонмо REST API SMS, Mobility, ишке ашыруу боюнча колдонмо REST API SMS, REST API SMS, API SMS, SMS |
