LINK Mobility хэрэгжүүлэх гарын авлага REST API SMS
LINK Mobility нь мессеж дамжуулах, бичил төлбөр хийх, байршилд суурилсан үйлчилгээ үзүүлдэг. Энэхүү платформ нь үйлчилгээ үзүүлэгч болон операторуудын хооронд ил тод, цагаан шошготой контент хүлээн авагч, гүйлгээний чиглүүлэгчийн үүрэг гүйцэтгэдэг.
LINK Mobility нь SMS илгээх гэх мэт LINK Mobility үйлчилгээнд хандахад ашиглаж болох RESTful API-г өгдөг. Энэхүү API нь ашиглахад хялбар бөгөөд орчин үеийн бүх хэл, хүрээтэй нийцтэй байхаар бүтээгдсэн. Таны сонгосон хэлийг ашигласнаар таны аппликейшн Link Mobility REST API-г ашиглан хүчирхэг мессеж илгээх болон төлбөрийн чадварыг хэрэгжүүлэх боломжтой.
© LINK Mobility, 10 оны 2021-р сарын XNUMX
Хууль эрх зүйн мэдээлэл
Энэхүү баримт бичигт өгөгдсөн мэдээлэл нь Netsize-ийн цорын ганц өмч бөгөөд зохиогчийн эрх юм. Энэ нь нууц бөгөөд мэдээллийн зорилгоор ашиглахад зориулагдсан. Энэ нь заавал биелүүлэх үүрэг хүлээхгүй бөгөөд мэдэгдэлгүйгээр өөрчлөлт оруулах боломжтой. Аливаа зөвшөөрөлгүй задруулах, ашиглах нь хууль бус гэж үзнэ.
Netsize™ болон linkmobility™ нь Франц, EEC болон олон улсын оюуны өмчийн хуулиар хамгаалагдсан.
Иш татсан бусад бүх барааны тэмдэг нь тус тусын эзэмшигчийн цорын ганц өмч юм.
Энд агуулагдах зүйл нь Netsize патент, зохиогчийн эрх, барааны тэмдгийн дор ямар нэгэн лиценз, эрх олгосон гэж ойлгохгүй.
NETSIZE
Société anonime or capital de 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. 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 мессежийг хаягласан хэрэглэгч рүү хүргэдэг.
SMS мессежийг хэрэглэгчийн төхөөрөмжид хүргэх үед хүргэлтийн тайлан гарч ирнэ.
Хүргэлтийн тайланг Үйлчилгээ үзүүлэгч рүү илгээнэ. Тайлан нь 2-р алхамд буцаасантай ижил мессеж ID-г агуулна.
Альтернатив урсгал: Хүчингүй хүсэлт
Хэрэв хүсэлтэд оруулсан параметрүүд эсвэл хэрэглэгчийн итгэмжлэлүүд хүчингүй бол алдааг Үйлчилгээ үзүүлэгч рүү буцаана. Алдаа нь татгалзсан шалтгааныг харуулж, урсгал нь дуусна. Мессежийн ID-г буцааж өгөхгүй.
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/илгээх |
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, хэрэв хэрэглэгчийн нэр нь john, changeme нь нууц үг бол зөвшөөрөл олгох толгой хэсэг нь:
Зөвшөөрөл: Үндсэн am9objpjaGFuZ2VtZSA=
Хэрэглэгчийн нэр, нууц үгээ хүсэлтийн параметр болгон оруулах боломжтой. Энэ нь зөвхөн үндсэн баталгаажуулалтыг дэмждэггүй үйлчлүүлэгчдэд зориулагдсан.
6. Хүсэлт гаргах
6.1 Асуулгын мөр
Хүсэлтийн параметрүүдийг нэр/утга хос агуулсан асуулгын мөр болгон илгээдэг. Асуулгын мөрийг Хувийн кодчилол ашиглан кодлодог.URL кодчилол).
http://www.w3schools.com/tags/ref_urlencode.asp
Жишээ ньample, Сайн уу Дэлхий! Hello+World%21 гэж кодлогдсон.
6.2 Заавал хүсэлт гаргах параметрүүд
| Нэр | Хамгийн их урт | Тодорхойлолт |
| очих хаяг | 40 | Улс орны кодоос эхлээд SMS мессежийг илгээх ёстой MSISDN. Жишээ ньample: 46123456789. Зарим зах зээлийн хувьд (Хэрэглэгчийн MSISDN-ийг далдалсан байх ёстой) энэ утга нь "#" угтвартай үсэг, тоон өөр нэр байж болно. |
| мессежТекст | 1600 | SMS мессежийн агуулга. |
6.3 Нэмэлт хүсэлтийн параметрүүд (дэвшилтэт хэрэглээнд зориулагдсан)
| Нэр | Хамгийн их урт | Тодорхойлолт |
| гарал үүслийн хаяг | 16 | Гарч буй SMS мессежийн эх хаяг. Эхлэх хаягийн төрлийг originalatorTON параметрээр тодорхойлно. Богино тооны хамгийн их урт нь 16. Альфа тоон илгээгч нь хамгийн ихдээ 11 тэмдэгт бүхий GSM өгөгдмөл цагаан толгойгоор хязгаарлагддаг. MSISDN илгээгчийн хамгийн их урт нь 15 (destinationAddress элементтэй ижил форматыг ашигладаг). OriginatingAddress болон originatingTON-г систем сонгохдоо орхигдуулж болно. Энэ функц нь зах зээл болон тохиргооноос хамаарна. Операторын интеграцчлалаас хамааран зан байдал өөр байж болно. |
| үүсгэн байгуулагчТОН | 1 | Гарсан хаягийн дугаарын төрөл (TON): 0 - Богино тоо 1 – Альфа тоо (хамгийн их урт 11) 2 - MSISDN Гарал үүслийн хаяг болон TON-г систем сонгох үед орхигдуулж болно. Энэ функц нь зах зээл болон тохиргооноос хамаарна. Операторын интеграцчлалаас хамааран зан байдал өөр байж болно. |
| userDataHeader | 280 | Хэрэглэгчийн өгөгдлийн толгой хэсэг нь Хэрэглэгчийн өгөгдөлтэй хамт 140, өөрөөр хэлбэл зургаан талт кодчилолтой бол 280 октетийг агуулж болно. Энэ параметр нь үргэлж hex кодлогдсон байдаг. |
| DCS | 3 | Өгөгдлийн кодчилолын схем. Операторын интеграцчлалаас хамааран зан байдал өөр байж болно. |
| PID | 3 | Протоколын ID. Операторын интеграцчлалаас хамааран зан байдал өөр байж болно. |
| харьцангуйValidityTime | 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. |
| корреляцийн дугаар | 100 | Үйлчилгээ үзүүлэгчээс өгсөн ID нь Хүргэлтийн тайланд тусгагдах болно. |
| хэрэглэгчийн нэр | 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
Зөвшөөрөл: Үндсэн am9objpjaGFuZ2VtZSA=
6.4.2 POST
Кодлогдсон асуулгын мөрийг HTTP хүсэлтийн мессежийн хэсэгт илгээдэг. Агуулгын төрөл нь програм/x-www-form-urlкодлогдсон.
POST https://europe.ipx.com/restapi/v1/sms/send
Хөтлөгч: europe.ipx.com
Агуулгын төрөл: application / x-www-form-urlкодлогдсон
Зөвшөөрөл: Үндсэн am9objpjaGFuZ2VtZSA=
Агуулгын урт: 57
destinationAddress=46123456789&messageText=Hello+World%21
6.5 Огноо, цаг
REST API дахь огноо, цагийг илэрхийлдэг параметрүүд нь үргэлж UTC цагийн бүсэд байдаг (Зохицуулсан Universal Time). Цаг хугацааamps нь яг ийм форматтай мөр хэлбэрээр илэрхийлэгдэнэ:
2017-04-25T23:20:50Z
Энэ нь 20 оны 50-р сарын 23-ны өдрийн 25 цагаас хойшхи 2017 минут XNUMX секундын 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 дотоод танигч. Дэмжлэг, алдааг олж засварлахад ашигладаг. |
| мессежийн дугаар | 10 x 36 | Амжилттай мессеж бүрийн LINK Mobility өвөрмөц мессежийн ID-н массив (хэрэв мессежийг нэгтгэсэн тохиолдолд олон мессежийн ID-г буцаана). Алдаа гарсан тохиолдолд орхигдсон. |
7.4 Жишээ ньampхариултууд
Амжилт
HTTP/1.1 200 OK
Агуулгын төрөл: application/json
Агуулгын урт: 144
Огноо: 15 оны 2016-р сарын 13-ны Пүрэв, 20:31:XNUMX GMT
{“responseCode”:0,”responseMessage”:”Амжилт”,”цагamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Уншихад зориулж форматласан ижил JSON энд байна:
{
"хариултын код“: 0,
"хариу мессеж":"Амжилт",
"цаг хугацааamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"мессежийн дугаар“:[“1-4850879008”] }
Бүтэлгүйтэл
HTTP/1.1 200 OK
Агуулгын төрөл: application/json
Агуулгын урт: 148
Огноо: 15 оны 2016-р сарын 13-ны Пүрэв, 20:31:XNUMX GMT
{“responseCode”:1,”responseMessage”:” Буруу нэвтрэх буюу зөвшөөрөлгүй API ашиглалт”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Амжилт
HTTP/1.1 200 OK
Агуулгын төрөл: application/json
Агуулгын урт: 144
Огноо: 15 оны 2016-р сарын 13-ны Пүрэв, 20:31:XNUMX GMT
{“responseCode”:0,”responseMessage”:”Амжилт”,”цагamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Уншихад зориулж форматласан ижил JSON энд байна:
{
"хариултын код“: 0,
"хариу мессеж":"Амжилт",
"цаг хугацааamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"мессежийн дугаар“:[“1-4850879008”] }
Бүтэлгүйтэл
HTTP/1.1 200 OK
Агуулгын төрөл: application/json
Агуулгын урт: 148
Огноо: 15 оны 2016-р сарын 13-ны Пүрэв, 20:31:XNUMX GMT
{“responseCode”:1,”responseMessage”:” Буруу нэвтрэх буюу зөвшөөрөлгүй API ашиглалт”,”timestamp”:”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 | Агуулга нийлүүлэгчийн дээд хязгаарыг хэтрүүлсэн байна | Үйлчилгээ үзүүлэгч нь LINK Mobility руу хэт хурдан SMS мессеж илгээж байна. |
| 14 | Протоколын ID-г бүртгэл дэмждэггүй | Протоколын ID-г дэмждэггүй. |
| 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 | TON үүсгэгч хүчингүй байна. |
| 117 | Хүчингүй campнэр | вampнэр буруу байна. |
| 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”-ийг “Sequencia de teste em Portugues” гэж орчуулна.
9. Хүргэлтийн тайлан
Үйлчилгээ үзүүлэгч нь хэрэв заасан бол SMS мессежийн хүргэлтийн тайлан эсвэл илгээсэн MT мессежийн хүргэлтийн мэдэгдлийг хүсэх боломжтой. Эдгээр тайлангууд нь МТ мессежийг зорилтот Хэрэглэгчид хүргэх эсвэл устгасан, тухайлбал хугацаа нь дууссан эсвэл ямар нэг шалтгаанаар чиглүүлэх боломжгүй үед операторын SMSC-д идэвхждэг.
Зөвхөн SMS мессежийн эцсийн статусыг Үйлчилгээ үзүүлэгчид мэдээлнэ, өөрөөр хэлбэл хүргэгдсэн эсвэл устгагдсан. MT мессеж бүрт зөвхөн нэг тайлан гаргадаг. Устгасан статустай бол шалтгаан код хэрэгжиж болно. Энэ шалтгааны код нь SMS мессежийг хүргэхгүй байгаа шалтгааныг зааж өгдөг.
Тайланг LINK Mobility-ээр дамжуулж, HTTP протоколыг ашиглан Үйлчилгээ үзүүлэгч рүү илгээдэг.
Тайланг хүлээн авахын тулд Үйлчилгээ үзүүлэгч нь өмнө нь хэрэгжүүлэх шаардлагатайampJava Servlet эсвэл ASP.NET хуудас. Аль аль нь HTTP GET эсвэл POST хүсэлтийг хүлээн авдаг.
Параметрүүд
Хүсэлт нь дараах параметрүүдийг агуулна.
| Параметр | Төрөл | M/O/I* | Өгөгдмөл утга | Хамгийн их урт | Тодорхойлолт |
| MessageId | мөр | M | – | 22 | Энэ тайланд тохирох MT мессежийн мессежийн ID. |
| Очих газрын хаяг | мөр | M | – | 40 | Хэрэглэгчийн MSISDN, өөрөөр хэлбэл анхны MT мессежийн очих хаяг. |
| Статусын код | бүхэл тоо | M | 1 | Статусын код нь MT мессежийн төлөвийг заана. Холбогдох статус кодууд нь: 0 - хүргэсэн 2 – Устгасан (шалтгаан код хамаарна) |
|
| Цаг STamp | мөр | 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. |
| StatusText | мөр | O | – | 255 | Оператороос нэмэлт мэдээлэл авах, тухайлбал статус/шалтгааныг тодорхой бичвэрээр тайлбарлахын тулд орлуулагч. Операторын интеграцчлалаас хамааран зан байдал өөр байж болно. |
| Корреляцийн дугаар | мөр | O | – | 100 | SendRequest эсвэл SendTextRequest-д өгсөн корреляцийн ID. |
| Операторын сүлжээний код | бүхэл тоо | 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 кодчилсон.
Тэмдэгтийн кодчилол:
Үйлчилгээ үзүүлэгч нь аль тэмдэгтийн кодчилолыг ашиглахаа сонгох боломжтой:
UTF-8 (санал болгосон)
ISO-8859-1.
9.1 Үйлчилгээ үзүүлэгчийн хүлээн зөвшөөрөлт
Үйлчилгээ үзүүлэгч нь хүргэлтийн тайлан бүрийг хүлээн зөвшөөрөх ёстой. Хүлээн авалт нь эерэг, өөрөөр хэлбэл хүргэлтийн тайланг амжилттай хүлээн авсан эсвэл сөрөг, өөрөөр хэлбэл бүтэлгүйтэл байж болно.
Анхаарна уу: LINK Mobility нь хүргэлтийн тайланг уншихад 30 секундын хугацаатай байдаг. Хугацаа хэтэрсэн нь хүргэлтийг дахин оролдох (хэрэв дахин оролдохыг идэвхжүүлсэн бол) эсвэл хүргэлтийг цуцлах (хэрэв дахин оролдохыг идэвхгүй болгосон бол) өдөөх болно. Энэ нь Үйлчилгээ үзүүлэгчийн програм нь ялангуяа ачаалал ихтэй үед хурдан хариу өгөх ёстой гэсэн үг юм.
Хүргэлтийн тайланг боловсруулахаасаа өмнө LINK Mobility-д хандахыг зөвлөж байна.
Эерэг ба сөрөг хүлээн зөвшөөрөх дүрмийг дараах байдлаар тайлбарлав.
Эерэг хүлээн зөвшөөрөлт, ACK, хүргэлтийн тайланг хүргэсэн:
Дараах XML форматтай контенттой хослуулан HTTP 200 хүрээний хариу код:
Сөрөг хүлээн зөвшөөрөлт, NAK, хүргэлтийн тайлан ирээгүй:
Эерэг хүлээн зөвшөөрөхөөс өөр ямар ч хариу, жишээ ньample, сөрөг мэдэгдлийг ямар ч HTTP алдааны код эсвэл дараах XML контентоор өдөөдөг:
XML агуулгыг LINK Mobility дахин оролдох механизмыг удирдахад ашиглаж болно. Хэрэв идэвхжүүлсэн бол NAK нь дахин оролдох шалтгаан болно. Дахин оролдох механизмд тохируулагдаагүй үйлчилгээ үзүүлэгчдийн хувьд XML контент нь сонголттой.
Доорх нь HTTP POST хүсэлт болон хариултын жишээ юмampҮйлчилгээ үзүүлэгчид хүргэсэн хүргэлтийн тайлангийн le:
HTTP хүсэлт:
POST /контекст/апп HTTP/1.1
Агуулгын төрөл: application / x-www-form-urlкодлогдсон;charset=utf-8
Хост: сервер: порт
Агуулгын урт: xx
MessageId=213123213&Очих хаяг=46762050312&Оператор=Telia&OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
HTTP хариу:
HTTP/1.1 200 OK
Агуулгын төрөл: текст/энгийн
9.2 Дахин оролдоно уу
LINK Mobility систем нь амжилтгүй, өөрөөр хэлбэл хүлээн зөвшөөрөгдөөгүй хүргэлтийн тайланг хүргэхийг дахин оролдох боломжтой. Үйлчилгээ үзүүлэгч нь сонгосон дахин оролдох үйлдлийг сонгож болно:
Дахин оролдохгүй (анхдагч) – холболт хийх оролдлого амжилтгүй болсон, унших хугацаа дууссан эсвэл HTTP алдааны код гарсан тохиолдолд мессежийг устгах болно.
Дахин оролдоно уу – Мессежийг холболтын асуудал, унших завсарлага эсвэл сөрөг хүлээн зөвшөөрсөн тохиолдолд дахин илгээх болно.
NAK-г дахин оролдохыг идэвхжүүлсэн үед LINK Mobility-с дахин оролдох оролдлого үүсгэх ямар хувилбарууд болон дахин оролдлого хэрхэн ажилладгийг ойлгох нь чухал юм. Үйлчилгээ үзүүлэгч бүр өөрийн гэсэн дахин оролдох дараалалтай бөгөөд мессежийг мессежийн цаг хугацааны дагуу эрэмбэлдэгamp. Үйлчилгээ үзүүлэгч рүү илгээсэн мессежийн дарааллыг баталгаажуулаагүй ч Link Mobility нь хуучин мессежүүдийг үргэлж хамгийн түрүүнд хүргэхийг хичээдэг. Дахин оролдох дарааллаас мессежийг хассан гол шалтгаан нь TTL мессежийн хугацаа дуусах эсвэл (онолын хувьд) дахин оролдох дараалал дүүрэх гэсэн хоёр шалтгааны нэг юм. TTL нь Оператор ба данснаас хамаардаг, өөрөөр хэлбэл, оператор болон мессежийн төрлөөс хамааран өөр өөр байж болно, жишээлбэл, дээд зэргийн SMS эсвэл стандарт SMS мессеж.
Дахин оролдохыг идэвхжүүлсэн үйлчилгээ үзүүлэгч нь мессежийг хүлээн аваагүй эсэхийг баталгаажуулахын тулд MT мессежийн өвөрмөц ID-г шалгах ёстой.
Хүргэлтийн тайланг боловсруулах явцад алдаа гарсан тохиолдолд үйлчилгээ үзүүлэгч эдгээр энгийн дүрмийг дагаж мөрдөх нь чухал бөгөөд хэрэв алдааны шалтгаан нь: Түр зуурын, жишээлбэл, мэдээллийн сан байхгүй, NAK-ийг буцааж өгөх ёстой. LINK Mobility мессежийг дахин илгээх болно.
Байнгын болон дахин оролдлого нь ижил төрлийн асуудал үүсгэж болзошгүй тул ACK-г буцаах хэрэгтэй. Жишээ ньample, мессежийг зөв задлан шинжилж чадаагүй эсвэл гэнэтийн ажиллах үеийн алдаа гарсан үед.
Үүний дагуу арга хэмжээ авснаар хүргэлтийн тайланг дахин дахин илгээснээс болж ямар нэгэн түгжрэл, дамжуулах чадвар буурахгүй байхыг баталгаажуулна.
10. Хэрэгжүүлэх зөвлөмжүүд
1. Таныг ашиглах боломжтой web API руу хүсэлт илгээх хөтөч. Энэ нь ямар ч хөгжүүлэлтийн хэрэгсэлгүйгээр үйлчилгээг судлах, үнэлэхэд маш хялбар болгодог.
2. Chrome эсвэл Firefox-г JSON гэх мэт өргөтгөлтэй хамт ашиглахыг зөвлөж байнаView дажгүй форматтай JSON харуулах.
3. Бид SoapUI-г POST, Үндсэн баталгаажуулалтыг турших, HTTP хүсэлт болон хариу мессежийг шалгахад ашигласан.
4. вURL хэрэгсэл нь үндсэн баталгаажуулалт бүхий POST хүсэлтийг илгээхэд хэрэгтэй. Өмнө нь үзнэ үүampдоор.
curl POST \
-H “Агуулгын төрөл: програм/x-www-form-urlкодлогдсон" \
-H “Зөвшөөрөл: Үндсэн am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
– өгөгдөл “destinationAddress=46123456789&messageText=Hello+World%21”
_________________
Хувь хүний харилцаа холбоог өөрчлөх
Баримт бичиг / нөөц
 |
LINK Mobility хэрэгжүүлэх гарын авлага REST API SMS [pdf] Хэрэглэгчийн гарын авлага Mobility хэрэгжүүлэх гарын авлага REST API SMS, Mobility, хэрэгжүүлэх гарын авлага REST API SMS, REST API SMS, API SMS, SMS |
