ЛИНК Водич за имплементацију мобилности РЕСТ АПИ СМС
ЛИНК Мобилити пружа услугу за испоруку порука, микро плаћања и услуге засноване на локацији. Платформа делује као транспарентан, аквизитер садржаја са белом етикетом и рутер трансакција између провајдера услуга и оператера.
ЛИНК Мобилити пружа РЕСТфул АПИ који се може користити за приступ услугама ЛИНК Мобилити као што је слање СМС-а. Овај АПИ је дизајниран да буде једноставан за коришћење и компатибилан са свим модерним језицима и оквирима. Користећи језик по вашем избору, ваша апликација може да користи Линк Мобилити РЕСТ АПИ за имплементацију моћних могућности слања порука и плаћања
© ЛИНК Мобилност, 10. март 2021
Правне информације
Информације наведене у овом документу су искључиво власништво и ауторска права Нетсизе-а. Поверљиво је и намењено је искључиво информативној употреби. Није обавезујући и може бити подложан променама без претходне најаве. Свако неовлашћено откривање или коришћење сматраће се незаконитим.
Нетсизе™ и линкмобилити™ су заштићени француским, ЕЕЗ и међународним законима о интелектуалној својини.
Сви остали цитирани заштитни знакови су искључиво власништво њихових власника.
Ништа овде садржано неће се тумачити као давање било које лиценце или права под Нетсизе патентом, ауторским правима или жигом.
НЕТСИЗЕ
Социете анониме ау цапитал де 5 478 070 евра
Сиеге социал :62, авенуе Емиле Зола92100 Боулогне – Француска
418 712 477 РЦС Нантерре
http://www.LinkMobility.com
http://www.linkmobility.com
Обим документа
Овај документ описује како добављач услуге користи ЛИНК Мобилити РЕСТ АПИ за СМС. Намењен је техничким архитектама и дизајнерима који реализују услуге Провајдера услуга.
1. Основна употреба
Веома је лако послати СМС. Шаљете ХТТП захтев на ЛИНК Мобилити који се може постићи помоћу само а web претраживач.
2. Функционални прекоview
Систем ЛИНК Мобилити пружа следеће основне функције за СМС поруке:
Слање мобилних терминираних (МТ) СМС порука, као што су текстуалне или бинарне (нпр. ВАП Пусх) премиум и стандардне поруке.
Пријем извештаја о испоруци за послате МТ поруке.
Пријем СМС порука са мобилног порекла (МО), премијум и стандардна тарифа.
СМС РЕСТ АПИ је намењен слању МТ СМС порука стандардне брзине.
АПИ шаље све СМС поруке асинхроно, омогућавајући функције као што су:
„Опали и заборави“ – Пружалац услуге жели да има предвидљивије време одговора и не жели да чека резултат од Оператера.
Функција поновног покушаја – ЛИНК Мобилити ће поново послати поруку ако оператер има привремене проблеме.
2.1 Слање СМС поруке
Добављач услуга Нетсизе Цонсумер
- Пошаљите МТ поруку
- Врати ИД поруке
- Пошаљите СМС поруку
- Доставите извештај о испоруци
- Пошаљите извештај о испоруци
Основни ток слања СМС порука је описан на следећи начин:
Пружалац услуге поставља захтев за слање СМС поруке примаоцу преко ЛИНК Мобилити система.
ИД поруке се враћа добављачу услуге. Овај ИД се може користити за нпр. повезивање поруке са исправним извештајем о испоруци.
ЛИНК Мобилити управља рутирањем и испоручује СМС поруку адресираном потрошачу.
Извештај о испоруци се покреће, на пример, када се СМС порука достави на уређај Потрошача.
Извештај о испоруци се шаље Добављачу услуге. Извештај садржи исти ИД поруке као што је враћено у кораку 2.
Алтернативни ток: Неважећи захтев
Ако су наведени параметри или кориснички акредитиви у захтеву неважећи, грешка се враћа добављачу услуге. Грешка указује на разлог одбијања и ток се завршава. Не враћају се ИД-ови порука.
3. Крајња тачка
СМС ресурсу се приступа путем путање:
/рестапи/в1/смс
Example URL
https://europe.ipx.com/restapi/v1/sms
Ради безбедности везе, ЛИНК Мобилити РЕСТ АПИ је доступан само преко ХТТПС-а.
Сертификат сервера Линк Мобилити је потписан од стране Тхавте Сервер ЦА.
4. Операције
СМС услуга омогућава следеће операције:
| Име | Пут |
| Пошаљи | /рестапи/в1/смс/сенд |
4.1 Пошаљи
Операција слања се користи за слање СМС-а једном примаоцу.
Ова операција је намењена и основним и напредним корисницима. У најједноставнијем случају, за испоруку СМС-а потребни су само адреса одредишта и текст поруке. ЛИНК Мобилити ће открити шему кодирања података и извршити аутоматску конкатенацију поруке у више делова поруке ако је потребно.
За напредну употребу, добављач услуга може да користи опционе параметре за потпуну контролу форматирања поруке, укључујући заглавље корисничких података.
Добављач сервиса може да шаље повезане поруке, али припрему корисничких података и заглавља корисничких података мора извршити Добављач услуга и порука мора бити послата путем вишеструких захтева за слање ка ЛИНК Мобилити.
5. Аутентификација
Корисничко име и лозинка се шаљу у сваком захтеву користећи ХТТП Басиц Аутхентицатион Сцхеме.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Акредитиви се шаљу у заглављу ауторизације у ХТТП захтеву. Клијент конструише поље заглавља како је овде описано:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Фор екampле, ако је корисничко име јохн, а цхангеме лозинка, резултујуће заглавље ауторизације је:
Ауторизација: Основни ам9објпјаГФуЗ2ВтЗСА=
Као резервни, корисничко име и лозинка се могу послати као параметри захтева. Ово се препоручује само за клијенте који не подржавају Басиц Аутх.
6. Подношење захтева
6.1 Стринг упита
Параметри захтева се шаљу као стринг упита који садржи парове име/вредност. Стринг упита је кодиран коришћењем процентног кодирања (URL кодирање).
http://www.w3schools.com/tags/ref_urlencode.asp
Фор екampле, Здраво свет! је кодиран као Хелло+Ворлд%21.
6.2 Обавезни параметри захтева
| Име | Максимална дужина | Опис |
| дестинацијаАдреса | 40 | МСИСДН на који треба послати СМС поруку, почевши од кода земље. Прampле: 46123456789. За нека тржишта (где потрошачки МСИСДН мора бити прикривен) ова вредност такође може бити алфанумерички псеудоним, са префиксом „#“. |
| мессагеТект | 1600 | Садржај СМС поруке. |
6.3 Опциони параметри захтева (за напредну употребу)
| Име | Максимална дужина | Опис |
| оригинатингАддресс | 16 | Почетна адреса за одлазну СМС поруку. Тип изворне адресе је дефинисан параметром оригинаторТОН. Максимална дужина кратког броја је 16. Алфа нумерички пошиљалац је ограничен на ГСМ подразумевани алфабет са максималном дужином од 11 знакова. Максимална дужина МСИСДН пошиљаоца је 15 (користећи исти формат као елемент дестинатионАддресс). Може се изоставити када систем одабере оригинатингАддресс и оригинатингТОН. Ова функција зависи од тржишта и конфигурације. Понашање може да варира у зависности од интеграције Оператора. |
| оригинаторТОН | 1 | Тип броја изворне адресе (ТОН): 0 – Кратак број 1 – Алфа нумерички (максимална дужина 11) 2 – МСИСДН Може се изоставити када ће систем изабрати оригинатингАддресс и оригинатингТОН. Ова функција зависи од тржишта и конфигурације. Понашање може да варира у зависности од интеграције Оператора. |
| усерДатаХеадер | 280 | Заглавље корисничких података заједно са корисничким подацима може садржати до 140, односно 280 када је хексадецимално кодирано, октета. Овај параметар је увек хексадецимални кодиран. |
| ДЦС | 3 | Шема кодирања података. Понашање може да варира у зависности од интеграције Оператора. |
| ПИД | 3 | ИД протокола. Понашање може да варира у зависности од интеграције Оператора. |
| релативноВалидитиТиме | 6 | Релативно време важења у секундама (у односу на време подношења на ЛИНК Мобилити). Максимална вредност је 604800 (7 дана), а подразумевана вредност је 48 сати. Понашање може да варира у зависности од интеграције Оператора. |
| време испоруке | 20 | Тиместamp када треба да буде испоручена СМС порука (одложено време испоруке). Погледајте одељак о формату датума и времена. |
| статусРепортФлагс | 1 | Захтев за доставу извештаја: 0 – Нема извештаја о испоруци (подразумевано) 1 – Захтева се извештај о испоруци 9 – Захтева се извештај о испоруци сервера (ЛИНК Мобилити не прослеђује извештај добављачу услуга, већ га чини доступним у извештајима итд.) |
| campаигнНаме | 50 | Трансакције ЛИНК Мобилити су tagгед са овим именом. Користи се за груписање трансакција у извештајима о мобилности веза. |
| макЦонцатенатедМессагес | 1 | Вредност између 1 и 10 која дефинише колико је повезаних порука дозвољено. Подразумевано је 3. |
| цоррелатионИд | 100 | ИД који је дао добављач услуге који ће бити приказан у извештају о испоруци. |
| корисничко име | 100 | Пружа се као алтернатива ХТТП основној аутентификацији. |
| лозинка | 100 | Пружа се као алтернатива ХТТП основној аутентификацији. |
6.4 Методе ХТТП захтева
За максималну интероперабилност, АПИ подржава методе ХТТП ГЕТ и ПОСТ захтева. Друге ХТТП методе нису дозвољене.
6.4.1 ГЕТ
Кодирани стринг упита се додаје у URL.
ГЕТ
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&мессагеТект=Здраво+Свет%21
Ауторизација: Основни ам9објпјаГФуЗ2ВтЗСА=
6.4.2 ПОСТ
Кодирани стринг упита се шаље у телу поруке ХТТП захтева. Цонтент-Типе је апликација/к-ввв-форм-urlкодиран.
ПОСТ https://europe.ipx.com/restapi/v1/sms/send
Домаћин: еуропе.ипк.цом
Садржај-тип: апплицатион / к-ввв-форм-urlкодиран
Ауторизација: Основни ам9објпјаГФуЗ2ВтЗСА=
Дужина садржаја: 57
дестинацијаАддресс=46123456789&мессагеТект=Здраво+Свет%21
6.5 Датум и време
Параметри у РЕСТ АПИ-ју који представљају датум и време су увек у УТЦ временској зони (координисано универзално време). Тиместampс су представљени као стринг са овим тачним форматом:
2017-04-25T23:20:50Z
Ово представља 20 минута и 50 секунди након 23. сата 25. априла 2017. у УТЦ.
7. Порука одговора
Након пријема и тумачења поруке захтева, АПИ одговара поруком ХТТП одговора.
7.1 ХТТП статусни код
РЕСТ АПИ увек враћа ХТТП статусни код 200 ОК за обрађене захтеве. Тело поруке садржи параметар респонсеЦоде који се користи за одређивање тачног исхода.
7.2 Тело поруке
Тело поруке састоји се од ЈСОН-а који описује исход захтева.
http://json.org/
Линк Мобилити ЈСОН је у складу са Гоогле ЈСОН водичем за стил.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Параметри одговора
| Име | Максимална дужина | Опис |
| респонсеЦоде | 3 | 0 означава успешну трансакцију. |
| респонсеМессаге | 255 | Текстуални опис одговора, нпр. текст грешке. |
| тиместamp | 20 | Датум и време када је ЛИНК Мобилити обрадио захтев. (Погледајте одељак о формату датума/времена). |
| трацеИд | 36 | Интерни идентификатор Линк Мобилити. Користи се за подршку и решавање проблема. |
| мессагеИдс | 10 к 36 | Низ јединствених ИД-ова порука ЛИНК Мобилити за сваку успешну поруку (више ИД-ова порука се враћа ако је порука повезана). Изоставља се у случају неуспеха. |
7.4 Докampле респонсес
Успех
ХТТП/1.1 200 ОК
Тип садржаја: апликација/јсон
Дужина садржаја: 144
Датум: Тху, 15 Сеп 2016 13:20:31 ГМТ
{“респонсеЦоде”:0,”респонсеМессаге”:”Суццесс”,”тиместamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Ево истог ЈСОН формата за читљивост:
{
„респонсеЦоде“:0,
„респонсеМессаге“:”Успех”,
„тиместamp“:”2016-0915T13:20:31Z”,
„трацеИд“:”f678d30879fd4adc25f2”,
„мессагеИдс“:[“1-4850879008”]
}
Неуспех
ХТТП/1.1 200 ОК
Тип садржаја: апликација/јсон
Дужина садржаја: 148
Датум: Тху, 15 Сеп 2016 13:20:31 ГМТ
{“респонсеЦоде”:1,”респонсеМессаге”:” Неважећа пријава или неовлашћено коришћење АПИ-ја”,”тиместamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Успех
ХТТП/1.1 200 ОК
Тип садржаја: апликација/јсон
Дужина садржаја: 144
Датум: Тху, 15 Сеп 2016 13:20:31 ГМТ
{“респонсеЦоде”:0,”респонсеМессаге”:”Суццесс”,”тиместamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Ево истог ЈСОН формата за читљивост:
{
„респонсеЦоде“:0,
„респонсеМессаге“:”Успех”,
„тиместamp“:”2016-0915T13:20:31Z”,
„трацеИд“:”f678d30879fd4adc25f2”,
„мессагеИдс“:[“1-4850879008”]
}
Неуспех
ХТТП/1.1 200 ОК
Тип садржаја: апликација/јсон
Дужина садржаја: 148
Датум: Тху, 15 Сеп 2016 13:20:31 ГМТ
{“респонсеЦоде”:1,”респонсеМессаге”:” Неважећа пријава или неовлашћено коришћење АПИ-ја”,”тиместamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Кодови одговора
Следећи кодови одговора се могу вратити у одговору за слање:
| Код | Текст | Опис |
| 0 | Успех | Успешно извршено. |
| 1 | Неважеће пријављивање или неовлашћено коришћење АПИ-ја | ЛИНК Мобилити забрањује нетачно корисничко име или лозинку или добављача услуга. |
| 2 | Линк Мобилити блокира корисника | ЛИНК Мобилити блокира потрошача. |
| 3 | ЛИНК Мобилити не обезбеђује рад | Операција је блокирана за добављача услуге. |
| 4 | ЛИНК Мобилити је непознат потрошач | ЛИНК Мобилити је непознат потрошач. Или ако је псеудоним коришћен у захтеву; алиас није пронађен. |
| 5 | Потрошач је блокирао ову услугу у ЛИНК Мобилити | Потрошач је блокирао ову услугу у ЛИНК Мобилити. |
| 6 | Изворна адреса није подржана | Изворна адреса није подржана. |
| 7 | Алфа изворна адреса није подржана од стране налога | Налог не подржава алфа изворну адресу. |
| 8 | МСИСДН изворна адреса није подржана | МСИСДН изворна адреса није подржана. |
| 9 | ГСМ проширени није подржан | ГСМ проширени није подржан. |
| 10 | Уницоде није подржан | Уницоде није подржан. |
| 11 | Извештај о статусу није подржан | Извештај о статусу није подржан. |
| 12 | Потребна способност није подржана | Потребна могућност (осим горенаведених) за слање поруке није подржана. |
| 13 | Максимална стопа регулације добављача садржаја је премашена | Добављач услуга пребрзо шаље СМС поруке на ЛИНК Мобилити. |
| 14 | ИД протокола није подржан од стране налога | ИД протокола није подржан. |
| 15 | Прекорачено је ограничење повезивања порука | Број повезаних порука премашује максималан број захтеван. |
| 16 | Није могуће усмерити поруку. | ЛИНК Мобилити није могао да усмери поруку. |
| 17 | Забрањени временски период | Није дозвољено слање поруке током временског периода |
| 18 | Премало стање на рачуну провајдера услуга | Добављач услуга је блокиран због прениског стања |
| 50 | Делимичан успех | Делимичан успех при слању СМС поруке више прималаца. |
| 99 | Интерна грешка сервера | Друга грешка Линк Мобилити, контактирајте ЛИНК Мобилити подршку за више информација. |
| 100 | Неважећа адреса одредишта | Одредишна адреса (МСИСДН или псеудоним) је неважећа. |
| 102 | Неважећи референтни (повезани) ИД | ИД референце је неважећи, можда се референтни ИД већ користи, престар или непознат. |
| 103 | Неважећи назив налога | Назив налога је неважећи. |
| 105 | Неважећи мета подаци услуге | Мета подаци услуге су неважећи. |
| 106 | Неважећа адреса порекла | Почетна адреса је неважећа. |
| 107 | Неважећа алфанумеричка изворна адреса | Алфанумеричка изворна адреса је неважећа. |
| 108 | Неважеће време важења | Време важења је неважеће. |
| 109 | Неважеће време испоруке | Време испоруке је неважеће. |
| 110 | Неважећи садржај поруке/кориснички подаци | Кориснички подаци, односно СМС порука су неважећи. |
| 111 | Неважећа дужина поруке | Дужина СМС поруке је неважећа. |
| 112 | Неважеће заглавље корисничких података | Заглавље корисничких података је неважеће. |
| 113 | Неважећа шема кодирања података | ДЦС је неважећи. |
| 114 | Неважећи ИД протокола | ПИД је неважећи. |
| 115 | Неважеће ознаке извештаја о статусу | Ознаке извештаја о статусу су неважеће. |
| 116 | Неважећи ТОН | Изворник ТОН је неважећи. |
| 117 | Неважећи цampаигн наме | Цampиме аигн је неважеће. |
| 120 | Неважеће ограничење за максималан број повезаних порука | Максималан број повезаних порука је неважећи. |
| 121 | Неважећа мсисдн изворна адреса | Изворна адреса МСИСДН-а је неважећа. |
| 122 | Неважећи ИД корелације | ИД корелације је неважећи. |
8. Опционе карактеристике
8.1 МСИСДН исправка
МСИСДН исправка је опциона функција коју може омогућити подршка ЛИНК Мобилити ако се то захтева.
Ова функција ће исправити одредишне адресе и ускладити их са потребним Е.164 форматом. Поред исправке формата, систем такође може да обавља функције специфичне за тржиште, као што је превођење међународних француских бројева за исправљање ДОМ-ТОМ (департементс ет территоирес д'оутре-мер) бројева када је то примењиво.
Испод је неколико екс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 (француски број преведен на ДОМ-ТОМ број) |
Додатно, могуће је дозволити националне телефонске бројеве за одабрано тржиште. Када је ова функција омогућена, сви међународни бројеви за друга тржишта морају бити послати са почетним знаком `+' да би се разликовали од изабраног тржишта.
Испод је неколико прampисправке урађене када се користи Шведска (шифра земље 46) као подразумевано тржиште за националне бројеве.
| Послата адреса одредишта | Исправљена адреса одредишта |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Неважећи јер недостаје знак „+“. |
Имајте на уму да ће исправљени МСИСДН користити ЛИНК Мобилити и да ће бити враћен у извештајима о испоруци.
За више информација контактирајте ЛИНК Мобилити подршку.
8.2 Замена карактера
Замена карактера је опциона функција коју може да омогући ЛИНК Мобилити подршка ако се то захтева.
Ова функција ће превести знакове не-ГСМ абецеде у корисничким подацима (СМС текст) у еквивалентне знакове ГСМ абецеде када је ДЦС подешен на „ГСМ“ (17). Фор екampле „Секуенциа де тесте ем Португуес“ ће бити преведено у „Секуенциа де тесте ем Португуес“.
9. Извештаји о испоруци
Добављач услуга може, ако је обезбеђен, да захтева извештаје о испоруци СМС порука или обавештења о испоруци за послате МТ поруке. Ови извештаји се покрећу у СМСЦ оператеру када се МТ порука или испоручи циљаном потрошачу или обрише, на пример, истекла или, из неког разлога, није рутабилна.
Провајдеру се пријављује само коначни статус СМС поруке, односно испоручена или обрисана. Генерише се само један извештај по МТ поруци. Са избрисаним статусом може се применити шифра разлога. Ова шифра разлога наводи разлог зашто СМС порука није испоручена.
Извештаји се рутирају преко ЛИНК Мобилити и шаљу добављачу услуга користећи ХТТП протокол.
Да би примио извештаје, Пружалац услуга треба да примени нпрampле Јава сервлет или АСП.НЕТ страницу. Оба примају ХТТП ГЕТ или ПОСТ захтеве.
Параметерс
Захтев садржи следеће параметре:
| Параметар | Тип | М/О/И* | Подразумевана вредност | Максимална дужина | Опис |
| МессагеИд | стринг | M | – | 22 | ИД поруке МТ поруке којој овај извештај одговара. |
| ДестинатионАддресс | стринг | M | – | 40 | МСИСДН корисника, односно одредишна адреса оригиналне МТ поруке. |
| СтатусЦоде | цео број | M | 1 | Статусни код означава статус МТ поруке. Применљиви статусни кодови су: 0 – Испоручено 2 – Избрисано (примењује се шифра разлога) |
|
| ТимеСтamp | стринг | M | – | 20 | Време које показује када је ЛИНК Мобилити примио извештај о испоруци. Временска зона временаamp је ЦЕТ или ЦЕСТ (са летњим рачунањем времена како је дефинисано за ЕУ). Формат: ггггММдд ХХ:мм:сс. |
| Оператер | стринг | M | – | 100 | Име Оператера који се користи приликом слања СМС поруке или назив налога који се користи приликом слања СМС поруке. Листу доступних оператера обезбеђује ЛИНК Мобилити подршка. |
| РеасонЦоде | цео број | O | – | 3 | Шифра разлога показује зашто је порука завршила у статусу избрисана. Применљиве шифре разлога су: 100 – истекао 101 – Одбијено 102 – Грешка у формату 103 – Друга грешка 110 – Претплатник непознат 111 – Претплатник забрањен 112 – Претплатник није обезбеђен 113 – Претплатник недоступан 120 – СМСЦ квар 121 – Загушење СМСЦ-а 122 – СМСЦ роминг 130 – Грешка слушалице 131 – Меморија слушалице је прекорачена Понашање може да варира у зависности од интеграције Оператора. |
| ОператорТимеСтamp | стринг | O | – | 20 | Време које показује када је извештај покренут у СМСЦ-у Оператора (ако га је обезбедио Оператер). Временска зона временаamp је ЦЕТ или ЦЕСТ (са летњим рачунањем времена како је дефинисано за ЕУ). Формат: ггггММдд ХХ:мм:сс. |
| СтатусТект | стринг | O | – | 255 | Чувар места за додатне информације од Оператера, нпр. јасан текстуални опис статуса/разлога. Понашање се може разликовати у зависности од интеграција оператера. |
| ЦоррелатионИд | стринг | O | – | 100 | ИД корелације наведен у СендРекуест или СендТектРекуест. |
| ОператорНетворкЦоде | цео број | O | – | 6 | Код мобилне мреже (МЦЦ + МНЦ) оператера. |
* М = обавезно, О = опционо, И = занемарено.
Добављач услуга мора да обезбеди ЛИНК Мобилити са циљем URL за извештаје о испоруци (опционо укључујући акредитиве за ХТТП основну аутентификацију). Добављач услуга може да изабере који ће жељени ХТТП метод користити:
ХТТП ПОСТ (препоручено)
ХТТП ГЕТ.
Exampле користећи ХТТП ГЕТ (успешно испоручено):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Exampле користећи ХТТП ГЕТ (није испоручено, оператер је дао временски оквирamp за догађај):
Параметри су URL енцодеди.
Кодирање знакова:
Добављач услуга може да изабере које ће жељено кодирање карактера користити:
УТФ-8 (препоручено)
ИСО-8859-1.
9.1 Потврда добављача услуга
Добављач услуга треба да потврди сваки извештај о испоруци. Потврда може бити позитивна, односно извештај о испоруци успешно примљен, или негативан, односно неуспешан.
Имајте на уму: ЛИНК Мобилити има временско ограничење за читање за потврде од 30 секунди за извештаје о испоруци. Временско ограничење ће покренути поновни покушај испоруке (ако је поновни покушај омогућен) или отказивање испоруке (ако је поновни покушај онемогућен). То значи да апликација добављача услуга мора да обезбеди брзо време одговора, посебно током великог оптерећења.
Веома је препоручљиво да потврдите извештај о испоруци ЛИНК Мобилити-у пре него што га обрадите.
Правило за позитивно и негативно признање је описано на следећи начин:
Позитивна потврда, АЦК, достављен извештај о испоруци:
ХТТП 200 код одговора опсега у комбинацији са следећим КСМЛ форматираним садржајем:
Негативна потврда, НАК, извештај о испоруци није достављен:
Сваки одговор осим позитивног признања, нпрampда, негативну потврду покреће било који ХТТП код грешке или следећи КСМЛ садржај:
КСМЛ садржај се може користити за контролу механизма поновног покушаја ЛИНК Мобилити. НАК ће изазвати покушај поновног покушаја, ако је омогућен. За добављаче услуга који нису конфигурисани за механизам поновног покушаја, КСМЛ садржај је опционалан.
Испод је ХТТП ПОСТ захтев и одговор нпрampле извештаја о испоруци достављеног добављачу услуга:
ХТТП захтев:
ПОСТ /цонтект/апп ХТТП/1.1
Садржај-тип: апплицатион / к-ввв-форм-urlенцодед;цхарсет=утф-8
Хост: сервер:порт
Дужина садржаја: кк
МессагеИд=213123213&ДестинатионАддресс=46762050312&Оператор=Телиа& ОператорТимеСтamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
ХТТП одговор:
ХТТП/1.1 200 ОК
Цонтент-Типе: тект/плаин
9.2 Покушај поново
Систем ЛИНК Мобилити може да изврши покушаје поновног покушаја за неуспеле, тј. непотврдјене испоруке извештаја о испоруци. Добављач услуга може изабрати жељено понашање за поновни покушај:
Нема поновног покушаја (подразумевано) – порука ће бити одбачена ако покушај повезивања не успе, истекне време за читање или за било који ХТТП код грешке.
Покушајте поново – порука ће бити поново послата за сваку врсту проблема са везом, временско ограничење читања или негативну потврду.
Када је омогућен поновни покушај за НАК, важно је разумети који сценарији ће генерисати покушај поновног покушаја од ЛИНК Мобилити и како тај поновни покушај функционише. Сваки провајдер услуга има свој ред за поновни покушај, где су поруке поређане према времену порукеamp. Линк Мобилити увек прво покушава да испоручи старије поруке, иако појединачни редослед порука испоручених добављачу услуга није загарантован. Главни разлог зашто се поруке одбацују из реда за поновни покушај је један од два разлога: или ТТЛ порука истиче или (теоретски) ред за поновни покушај постаје пун. ТТЛ зависи од оператера и налога, тј. може да варира у зависности од оператера и/или типа поруке, нпр. премијум СМС или СМС порука са стандардном тарифом.
Добављачи услуга са омогућеним поновним покушајем морају да провере јединствени ИД МТ поруке да би се уверили да порука већ није примљена.
Важно је да се добављач услуга придржава ових једноставних правила када дође до грешке током обраде извештаја о испоруци ако је разлог грешке: привремени, нпр. база података није доступна, треба вратити НАК. ЛИНК Мобилити ће поново послати поруку.
Трајни и покушај поновног покушаја ће вероватно изазвати исту врсту проблема, АЦК треба да се врати. Фор екampле, када порука није могла да се правилно рашчлани или је изазвала неочекивану грешку током извршавања.
Поступање у складу са тим ће обезбедити да не дође до блокирања или деградације протока услед вишеструког слања извештаја о испоруци.
10. Савети за примену
1. Могуће је користити свој web претраживач да поднесе захтеве АПИ-ју. Ово чини веома лаким истраживање и процену услуга без икаквих развојних алата.
2. Цхроме или Фирефок се препоручују заједно са екстензијом као што је ЈСОНView да прикаже прилично форматиран ЈСОН.
3. Користили смо СоапУИ за тестирање ПОСТ-а, основну аутентификацију и за проверу необрађених порука ХТТП захтева и одговора.
4. ЦURL алатка је корисна за подношење ПОСТ захтева са основном аутентификацијом. Види прampле испод.
curl ПОСТ \
-Х „Тип садржаја: апликација/к-ввв-форм-urlкодирано” \
-Х “Овлашћење: Основни ам9објпјаГФуЗ2ВтЗСА=” \
https://europe.ipx.com/restapi/v1/sms/send \
–подаци “дестинатионАддресс=46123456789&мессагеТект=Хелло+Ворлд%21”
_______________
Трансформисање персонализованих комуникација
Документи / Ресурси
 | Водич за имплементацију мобилности РЕСТ АПИ СМС |
Референце
- Упутство за употребуmanual.tools