LINK ຄູ່ມືການປະຕິບັດການເຄື່ອນທີ່ 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 au capital de 5 478 070 ເອີໂຣ
Siège social :62, avenue Emile Zola92100 Boulogne – France
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
ຂອບເຂດຂອງເອກະສານ
ເອກະສານນີ້ອະທິບາຍວິທີທີ່ຜູ້ໃຫ້ບໍລິການໃຊ້ LINK Mobility REST API ສໍາລັບ SMS. ມັນມີຈຸດປະສົງສໍາລັບສະຖາປະນິກດ້ານວິຊາການແລະນັກອອກແບບທີ່ປະຕິບັດການບໍລິການຂອງຜູ້ໃຫ້ບໍລິການ.
1. ການນໍາໃຊ້ພື້ນຖານ
ມັນງ່າຍຫຼາຍທີ່ຈະສົ່ງ SMS. ທ່ານສົ່ງຄໍາຮ້ອງຂໍ HTTP ໄປຫາ LINK Mobility ທີ່ສາມາດເຮັດໄດ້ໂດຍໃຊ້ພຽງແຕ່ a web ຕົວທ່ອງເວັບ.
2. Functional Overview
ລະບົບ LINK Mobility ສະຫນອງການທໍາງານພື້ນຖານຕໍ່ໄປນີ້ສໍາລັບຂໍ້ຄວາມ SMS:
ການສົ່ງຂໍ້ຄວາມ SMS ທີ່ຖືກຍົກເລີກໃນມືຖື (MT) ເຊັ່ນ: ຂໍ້ຄວາມ ຫຼື binary (ເຊັ່ນ: WAP Push) ຂໍ້ຄວາມທີ່ນິຍົມ ແລະມາດຕະຖານມາດຕະຖານ.
ໄດ້ຮັບບົດລາຍງານການຈັດສົ່ງສໍາລັບຂໍ້ຄວາມ MT ທີ່ສົ່ງ.
ການຮັບຂໍ້ຄວາມ SMS ຕົ້ນກໍາເນີດໂທລະສັບມືຖື (MO), premium ແລະອັດຕາມາດຕະຖານ.
SMS REST API ແມ່ນອຸທິດຕົນເພື່ອສົ່ງຂໍ້ຄວາມ MT SMS ອັດຕາມາດຕະຖານ.
API ສົ່ງຂໍ້ຄວາມ SMS ທັງຫມົດ asynchronously, ເຮັດໃຫ້ຄຸນສົມບັດເຊັ່ນ:
“Fire-and-forget” – ຜູ້ໃຫ້ບໍລິການຕ້ອງການໃຫ້ມີເວລາຕອບໂຕ້ທີ່ຄາດເດົາໄດ້ຫຼາຍຂຶ້ນ ແລະບໍ່ຕ້ອງການລໍຖ້າຜົນໄດ້ຮັບຈາກຜູ້ປະຕິບັດງານ.
ລອງຟັງຊັນໃໝ່ – LINK Mobility ຈະສົ່ງຂໍ້ຄວາມຄືນໃໝ່ຖ້າ Operator ມີບັນຫາຊົ່ວຄາວ.
2.1 ການສົ່ງຂໍ້ຄວາມ SMS
ຜູ້ໃຫ້ບໍລິການ Netsize ຜູ້ບໍລິໂພກ
- ສົ່ງຂໍ້ຄວາມ MT
- ກັບຄືນ ID ຂໍ້ຄວາມ
- ສົ່ງຂໍ້ຄວາມ SMS
- ສົ່ງບົດລາຍງານການຈັດສົ່ງ
- ສົ່ງບົດລາຍງານການຈັດສົ່ງ
ຂັ້ນຕອນພື້ນຖານສໍາລັບການສົ່ງຂໍ້ຄວາມ SMS ແມ່ນອະທິບາຍດັ່ງຕໍ່ໄປນີ້:
ຜູ້ໃຫ້ບໍລິການເຮັດການຮ້ອງຂໍໃຫ້ສົ່ງຂໍ້ຄວາມ SMS ໄປຫາຜູ້ຮັບຜ່ານລະບົບ LINK Mobility.
ID ຂໍ້ຄວາມຖືກສົ່ງຄືນໃຫ້ຜູ້ໃຫ້ບໍລິການ. ID ນີ້ສາມາດຖືກນໍາໃຊ້ສໍາລັບຕົວຢ່າງ correlate ຂໍ້ຄວາມທີ່ມີບົດລາຍງານການຈັດສົ່ງທີ່ຖືກຕ້ອງ.
LINK Mobility ຈັດການການກຳນົດເສັ້ນທາງ ແລະສົ່ງຂໍ້ຄວາມ SMS ໄປຫາຜູ້ບໍລິໂພກທີ່ລະບຸໄວ້.
ບົດລາຍງານການຈັດສົ່ງແມ່ນໄດ້ຮັບການກະຕຸ້ນ, ເຊັ່ນ: ໃນເວລາທີ່ຂໍ້ຄວາມ SMS ໄດ້ຖືກສົ່ງໄປຫາອຸປະກອນຂອງຜູ້ບໍລິໂພກ.
ບົດລາຍງານການຈັດສົ່ງແມ່ນຖືກສົ່ງໄປຫາຜູ້ໃຫ້ບໍລິການ. ບົດລາຍງານປະກອບມີ ID ຂໍ້ຄວາມດຽວກັນກັບສົ່ງຄືນໃນຂັ້ນຕອນ 2.
ກະແສທາງເລືອກ: ການຮ້ອງຂໍບໍ່ຖືກຕ້ອງ
ຖ້າພາລາມິເຕີທີ່ສະໜອງໃຫ້ ຫຼືຂໍ້ມູນປະຈຳຕົວຂອງຜູ້ໃຊ້ໃນຄຳຮ້ອງຂໍບໍ່ຖືກຕ້ອງ, ຂໍ້ຜິດພາດຈະຖືກສົ່ງຄືນໃຫ້ຜູ້ໃຫ້ບໍລິການ. ຄວາມຜິດພາດຊີ້ໃຫ້ເຫັນເຫດຜົນສໍາລັບການປະຕິເສດແລະການໄຫຼສິ້ນສຸດລົງ. ບໍ່ມີ 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/send |
4.1 ສົ່ງ
ການປະຕິບັດການສົ່ງແມ່ນໃຊ້ເພື່ອສົ່ງ SMS ໄປຫາຜູ້ຮັບຄົນດຽວ.
ການປະຕິບັດງານນີ້ແມ່ນມີຈຸດປະສົງສໍາລັບທັງຜູ້ໃຊ້ຂັ້ນພື້ນຖານແລະຂັ້ນສູງ. ໃນກໍລະນີທີ່ງ່າຍທີ່ສຸດ, ພຽງແຕ່ທີ່ຢູ່ຈຸດຫມາຍປາຍທາງ, ແລະຂໍ້ຄວາມແມ່ນຕ້ອງການເພື່ອສົ່ງ SMS. LINK Mobility ຈະກວດຫາລະບົບການເຂົ້າລະຫັດຂໍ້ມູນ ແລະປະຕິບັດການລວມຂໍ້ຄວາມອັດຕະໂນມັດເຂົ້າໄປໃນຫຼາຍພາກສ່ວນຂໍ້ຄວາມຖ້າຈໍາເປັນ.
ສໍາລັບການນໍາໃຊ້ຂັ້ນສູງ, ຜູ້ໃຫ້ບໍລິການສາມາດໃຊ້ພາລາມິເຕີທາງເລືອກສໍາລັບການຄວບຄຸມການຈັດຮູບແບບຂໍ້ຄວາມລວມທັງສ່ວນຫົວຂໍ້ມູນຜູ້ໃຊ້.
ຜູ້ໃຫ້ບໍລິການສາມາດສົ່ງຂໍ້ຄວາມທີ່ປະສົມປະສານໄດ້, ແຕ່ການກະກຽມຂໍ້ມູນຜູ້ໃຊ້ແລະສ່ວນຫົວຂໍ້ມູນຜູ້ໃຊ້ຕ້ອງຖືກເຮັດໂດຍຜູ້ໃຫ້ບໍລິການແລະຂໍ້ຄວາມຕ້ອງຖືກສົ່ງໂດຍວິທີການສົ່ງຫຼາຍຄໍາຮ້ອງຂໍໄປສູ່ LINK Mobility.
5. ການຢືນຢັນ
ຊື່ຜູ້ໃຊ້ແລະລະຫັດຜ່ານຖືກສົ່ງໃນທຸກໆຄໍາຮ້ອງຂໍໂດຍໃຊ້ HTTP Basic Authentication Scheme.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
ຂໍ້ມູນປະຈໍາຕົວຖືກສົ່ງໃນຫົວຂໍ້ການອະນຸຍາດໃນຄໍາຮ້ອງຂໍ HTTP. ລູກຄ້າສ້າງຊ່ອງຂໍ້ມູນ header ດັ່ງທີ່ໄດ້ອະທິບາຍຢູ່ທີ່ນີ້:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
ຕົວຢ່າງample, ຖ້າຊື່ຜູ້ໃຊ້ແມ່ນ john ແລະ changeme ແມ່ນລະຫັດຜ່ານຫຼັງຈາກນັ້ນຫົວຂໍ້ການອະນຸຍາດຜົນໄດ້ຮັບແມ່ນ:
ການອະນຸຍາດ: ພື້ນຖານ am9objpjaGFuZ2VtZSA=
ໃນຖານະເປັນການຫຼຸດລົງຊື່ຜູ້ໃຊ້ແລະລະຫັດຜ່ານສາມາດຖືກສົ່ງເປັນຕົວກໍານົດການຮ້ອງຂໍ. ນີ້ແມ່ນແນະນໍາພຽງແຕ່ສໍາລັບລູກຄ້າທີ່ບໍ່ສະຫນັບສະຫນູນພື້ນຖານ Auth.
6. ການຍື່ນຄໍາຮ້ອງຂໍ
6.1 ແຖບຄໍາຖາມ
ພາລາມິເຕີການຮ້ອງຂໍຖືກສົ່ງເປັນສະຕຣິງຄໍາຖາມທີ່ມີຊື່ / ຄ່າຄູ່. ສະຕຣິງແບບສອບຖາມຖືກເຂົ້າລະຫັດໂດຍໃຊ້ Percent Encoding (URL ການເຂົ້າລະຫັດ).
http://www.w3schools.com/tags/ref_urlencode.asp
ຕົວຢ່າງample, ສະບາຍດີໂລກ! ຖືກເຂົ້າລະຫັດເປັນ Hello+World%21.
6.2 ຕົວກໍານົດການຮ້ອງຂໍບັງຄັບ
| ຊື່ | ຄວາມຍາວສູງສຸດ | ລາຍລະອຽດ |
| ທີ່ຢູ່ປາຍທາງ | 40 | MSISDN ທີ່ຂໍ້ຄວາມ SMS ຄວນຖືກສົ່ງໄປຫາ, ເລີ່ມຕົ້ນດ້ວຍລະຫັດປະເທດ. ຕົວຢ່າງample: 46123456789. ສໍາລັບບາງຕະຫຼາດ (ບ່ອນທີ່ຜູ້ບໍລິໂພກ MSISDN ຈະຕ້ອງຖືກເຮັດໃຫ້ສັບສົນ) ຄ່ານີ້ຍັງສາມາດເປັນຕົວຫຍໍ້ທີ່ເປັນຕົວອັກສອນ ແລະຕົວເລກ, ນໍາໜ້າດ້ວຍ “#”. |
| ຂໍ້ຄວາມ | 1600 | ເນື້ອໃນຂໍ້ຄວາມ SMS. |
6.3 ຕົວກໍານົດການຮ້ອງຂໍທາງເລືອກ (ສໍາລັບການນໍາໃຊ້ຂັ້ນສູງ)
| ຊື່ | ຄວາມຍາວສູງສຸດ | ລາຍລະອຽດ |
| ທີ່ຢູ່ຕົ້ນກໍາເນີດ | 16 | ທີ່ຢູ່ຕົ້ນສະບັບຂອງຂໍ້ຄວາມ SMS ຂາອອກ. ປະເພດຂອງທີ່ຢູ່ຕົ້ນສະບັບແມ່ນຖືກກໍານົດໂດຍຕົວກໍານົດການຕົ້ນກໍາເນີດTON. ຄວາມຍາວສູງສຸດຂອງຕົວເລກສັ້ນແມ່ນ 16. ຕົວສົ່ງຕົວເລກ Alpha ຖືກຈຳກັດໃສ່ຕົວອັກສອນເລີ່ມຕົ້ນ GSM ທີ່ມີຄວາມຍາວສູງສຸດ 11 ຕົວອັກສອນ. ຄວາມຍາວສູງສຸດຂອງຜູ້ສົ່ງ MSISDN ແມ່ນ 15 (ໃຊ້ຮູບແບບດຽວກັນກັບອົງປະກອບທີ່ຢູ່ປາຍທາງ). ສາມາດຖືກລະເວັ້ນເມື່ອມີທີ່ຢູ່ ແລະຕົ້ນກຳເນີດTON ຖືກເລືອກໂດຍລະບົບ. ຫນ້າທີ່ນີ້ແມ່ນຕະຫຼາດແລະການຕັ້ງຄ່າຂຶ້ນກັບ. ພຶດຕິກໍາອາດຈະແຕກຕ່າງກັນກັບການລວມຕົວຂອງຜູ້ປະກອບການ. |
| ຕົ້ນກໍາເນີດTON | 1 | ທີ່ຢູ່ທີ່ມາຂອງໝາຍເລກ (TON): 0 – ຕົວເລກສັ້ນ 1 – ຕົວເລກອັນຟາ (ຄວາມຍາວສູງສຸດ 11) 2 – MSISDN ສາມາດຖືກລະເວັ້ນເມື່ອທີ່ຢູ່ແລະຕົ້ນກໍາເນີດTON ຈະຖືກເລືອກໂດຍລະບົບ. ຟັງຊັນນີ້ແມ່ນຂຶ້ນກັບຕະຫຼາດ ແລະການຕັ້ງຄ່າ. ພຶດຕິກໍາອາດຈະແຕກຕ່າງກັນກັບການລວມຕົວຂອງຜູ້ປະກອບການ. |
| userDataHeader | 280 | User Data Header ຮ່ວມກັບຂໍ້ມູນຜູ້ໃຊ້ສາມາດບັນຈຸໄດ້ເຖິງ 140, ie 280 ເມື່ອ hex-encoded, octets. ພາຣາມິເຕີນີ້ຖືກເຂົ້າລະຫັດ hex ສະເໝີ. |
| DCS | 3 | ໂຄງການລະຫັດຂໍ້ມູນ. ພຶດຕິກໍາອາດຈະແຕກຕ່າງກັນກັບການລວມຕົວຂອງຜູ້ປະກອບການ. |
| PID | 3 | ID ໂປຣໂຕຄໍ. ພຶດຕິກໍາອາດຈະແຕກຕ່າງກັນກັບການລວມຕົວຂອງຜູ້ປະກອບການ. |
| ເວລາທີ່ກ່ຽວຂ້ອງ | 6 | Relative validity time ເປັນວິນາທີ (ທຽບກັບເວລາສຳລັບການຍື່ນສະເໜີຕໍ່ LINK Mobility). ຄ່າສູງສຸດແມ່ນ 604800 (7 ມື້) ແລະຄ່າເລີ່ມຕົ້ນແມ່ນ 48 ຊົ່ວໂມງ. ພຶດຕິກໍາອາດຈະແຕກຕ່າງກັນກັບການລວມຕົວຂອງຜູ້ປະກອບການ. |
| ເວລາຈັດສົ່ງ | 20 | ເວລາamp ເມື່ອຂໍ້ຄວາມ SMS ຄວນຖືກສົ່ງ (ເວລາການຈັດສົ່ງຊັກຊ້າ). ເບິ່ງພາກສ່ວນກ່ຽວກັບຮູບແບບເວລາວັນທີ. |
| ລາຍງານສະຖານະ | 1 | ສົ່ງຄຳຮ້ອງຂໍລາຍງານ: 0 - ບໍ່ມີລາຍງານການຈັດສົ່ງ (ຄ່າເລີ່ມຕົ້ນ) 1 - ລາຍງານການຈັດສົ່ງທີ່ຮ້ອງຂໍ 9 - ລາຍງານການຈັດສົ່ງເຊີບເວີທີ່ຮ້ອງຂໍ (LINK Mobility ບໍ່ໄດ້ສົ່ງຕໍ່ບົດລາຍງານໄປຫາຜູ້ໃຫ້ບໍລິການແຕ່ເຮັດໃຫ້ມັນມີຢູ່ໃນບົດລາຍງານແລະອື່ນໆ). |
| campຊື່ | 50 | ທຸລະກໍາ LINK Mobility ແມ່ນ tagged ກັບຊື່ນີ້. ມັນຖືກນໍາໃຊ້ເພື່ອຈັດກຸ່ມທຸລະກໍາໃນລາຍງານ Link Mobility. |
| maxConcatenatedMessages | 1 | ຄ່າລະຫວ່າງ 1 ຫາ 10 ເຊິ່ງກຳນົດຈຳນວນຂໍ້ຄວາມທີ່ເຊື່ອມຕໍ່ກັນທີ່ອະນຸຍາດ. ຄ່າເລີ່ມຕົ້ນແມ່ນ 3. |
| correlationId | 100 | ID ສະໜອງໃຫ້ໂດຍຜູ້ໃຫ້ບໍລິການທີ່ຈະຖືກສະທ້ອນໃນລາຍງານການຈັດສົ່ງ. |
| ຊື່ຜູ້ໃຊ້ | 100 | ສະຫນອງໃຫ້ເປັນທາງເລືອກເພື່ອ HTTP Basic Authentication. |
| ລະຫັດຜ່ານ | 100 | ສະຫນອງໃຫ້ເປັນທາງເລືອກເພື່ອ HTTP Basic Authentication. |
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ເຂົ້າລະຫັດ.
ໂພສ https://europe.ipx.com/restapi/v1/sms/send
ເຈົ້າພາບ: europe.ipx.com
ເນື້ອຫາປະເພດ: ຄຳ ຮ້ອງສະ ໝັກ / x-www-form-urlເຂົ້າລະຫັດ
ການອະນຸຍາດ: ພື້ນຖານ 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 ຕົວລະບຸພາຍໃນ. ໃຊ້ສໍາລັບການສະຫນັບສະຫນູນແລະການແກ້ໄຂບັນຫາ. |
| messageIds | 10 x 36 | Array ຂອງ LINK Mobility ID ຂໍ້ຄວາມທີ່ເປັນເອກະລັກສໍາລັບແຕ່ລະຂໍ້ຄວາມທີ່ປະສົບຜົນສໍາເລັດ (ID ຂໍ້ຄວາມຫຼາຍຈະຖືກສົ່ງຄືນຖ້າຂໍ້ຄວາມຖືກປະສົມປະສານ). ຖືກລະເວັ້ນໃນກໍລະນີທີ່ລົ້ມເຫລວ. |
7.4 ຕົວຢ່າງample ຄໍາຕອບ
ສຳເລັດ
HTTP/1.1 200 ຕົກລົງ
ປະເພດເນື້ອຫາ: application/json
ຄວາມຍາວຂອງເນື້ອຫາ: 144
ວັນທີ: Thu, 15 Sep 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Success”,”ເວລາທີ່ສຸດamp”:”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
ຄວາມຍາວຂອງເນື້ອຫາ: 148
ວັນທີ: Thu, 15 Sep 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” ການເຂົ້າສູ່ລະບົບບໍ່ຖືກຕ້ອງ ຫຼືການນຳໃຊ້ API ທີ່ບໍ່ໄດ້ຮັບອະນຸຍາດ”,”ເວລາຫຼາຍທີ່ສຸດamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
ສຳເລັດ
HTTP/1.1 200 ຕົກລົງ
ປະເພດເນື້ອຫາ: application/json
ຄວາມຍາວຂອງເນື້ອຫາ: 144
ວັນທີ: Thu, 15 Sep 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Success”,”ເວລາທີ່ສຸດamp”:”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
ຄວາມຍາວຂອງເນື້ອຫາ: 148
ວັນທີ: Thu, 15 Sep 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” ການເຂົ້າສູ່ລະບົບບໍ່ຖືກຕ້ອງ ຫຼືການນຳໃຊ້ API ທີ່ບໍ່ໄດ້ຮັບອະນຸຍາດ”,”ເວລາຫຼາຍທີ່ສຸດamp”:”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 | ທີ່ຢູ່ຕົ້ນສະບັບຂອງ Alpha ບໍ່ຮອງຮັບບັນຊີ | ທີ່ຢູ່ຕົ້ນກໍາເນີດ alpha ບໍ່ໄດ້ຖືກຮອງຮັບໂດຍບັນຊີ. |
| 8 | ບໍ່ຮອງຮັບທີ່ຢູ່ຕົ້ນສະບັບ MSISDN | ບໍ່ຮອງຮັບທີ່ຢູ່ຕົ້ນສະບັບ MSISDN. |
| 9 | ບໍ່ຮອງຮັບການຂະຫຍາຍ GSM | ບໍ່ຮອງຮັບການຂະຫຍາຍ GSM. |
| 10 | ບໍ່ຮອງຮັບ Unicode | ບໍ່ຮອງຮັບ Unicode. |
| 11 | ບໍ່ຮອງຮັບລາຍງານສະຖານະ | ບໍ່ຮອງຮັບລາຍງານສະຖານະ. |
| 12 | ບໍ່ຮອງຮັບຄວາມສາມາດທີ່ຕ້ອງການ | ຄວາມສາມາດທີ່ຕ້ອງການ (ນອກຈາກຂ້າງເທິງ) ສໍາລັບການສົ່ງຂໍ້ຄວາມແມ່ນບໍ່ໄດ້ສະຫນັບສະຫນູນ. |
| 13 | ອັດຕາການປິດກັ້ນສູງສຸດຂອງຜູ້ໃຫ້ບໍລິການເນື້ອຫາແມ່ນເກີນ | ຜູ້ໃຫ້ບໍລິການສົ່ງຂໍ້ຄວາມ SMS ໄປຫາ LINK Mobility ໄວເກີນໄປ. |
| 14 | Protocol ID ບໍ່ຮອງຮັບບັນຊີ | ບໍ່ຮອງຮັບ Protocol ID. |
| 15 | ເກີນຂີດຈຳກັດການປະກອບຂໍ້ຄວາມແລ້ວ | ຈໍານວນຂໍ້ຄວາມທີ່ປະສົມປະສານເກີນຈໍານວນສູງສຸດທີ່ຮ້ອງຂໍ. |
| 16 | ບໍ່ສາມາດປ່ຽນເສັ້ນທາງຂໍ້ຄວາມໄດ້. | LINK Mobility ບໍ່ສາມາດສົ່ງເສັ້ນທາງຂໍ້ຄວາມໄດ້. |
| 17 | ໄລຍະເວລາທີ່ຫ້າມ | ບໍ່ອະນຸຍາດໃຫ້ສົ່ງຂໍ້ຄວາມໃນລະຫວ່າງໄລຍະເວລາ |
| 18 | ຍອດເງິນໃນບັນຊີຜູ້ໃຫ້ບໍລິການຕໍ່າເກີນໄປ | ຜູ້ໃຫ້ບໍລິການຖືກບລັອກເນື່ອງຈາກຍອດເງິນຕໍ່າເກີນໄປ |
| 50 | ຜົນສໍາເລັດບາງສ່ວນ | ສຳເລັດບາງສ່ວນເມື່ອສົ່ງຂໍ້ຄວາມ SMS ໄປຫາຜູ້ຮັບຫຼາຍອັນ. |
| 99 | ເຊີບເວີພາຍໃນຜິດພາດ | Link Mobility ອື່ນຜິດພາດ, ຕິດຕໍ່ຝ່າຍຊ່ວຍເຫຼືອ LINK Mobility ສໍາລັບຂໍ້ມູນເພີ່ມເຕີມ. |
| 100 | ທີ່ຢູ່ປາຍທາງບໍ່ຖືກຕ້ອງ | ທີ່ຢູ່ປາຍທາງ (MSISDN, ຫຼືນາມແຝງ) ບໍ່ຖືກຕ້ອງ. |
| 102 | ID ອ້າງອີງ (ເຊື່ອມຕໍ່) ບໍ່ຖືກຕ້ອງ | ID ອ້າງອີງບໍ່ຖືກຕ້ອງ, ບາງທີ ID ອ້າງອີງຖືກໃຊ້ແລ້ວ, ເກົ່າເກີນໄປ ຫຼືບໍ່ຮູ້. |
| 103 | ຊື່ບັນຊີບໍ່ຖືກຕ້ອງ | ຊື່ບັນຊີບໍ່ຖືກຕ້ອງ. |
| 105 | ຂໍ້ມູນເມຕາການບໍລິການບໍ່ຖືກຕ້ອງ | ຂໍ້ມູນ meta ການບໍລິການບໍ່ຖືກຕ້ອງ. |
| 106 | ທີ່ຢູ່ຕົ້ນສະບັບບໍ່ຖືກຕ້ອງ | ທີ່ຢູ່ຕົ້ນສະບັບບໍ່ຖືກຕ້ອງ. |
| 107 | ທີ່ຢູ່ຕົ້ນສະບັບທີ່ເປັນຕົວເລກແລະຕົວເລກບໍ່ຖືກຕ້ອງ | ທີ່ຢູ່ຕົ້ນສະບັບທີ່ເປັນຕົວເລກແລະຕົວເລກບໍ່ຖືກຕ້ອງ. |
| 108 | ເວລາທີ່ຖືກຕ້ອງບໍ່ຖືກຕ້ອງ | ເວລາທີ່ຖືກຕ້ອງແມ່ນບໍ່ຖືກຕ້ອງ. |
| 109 | ເວລາຈັດສົ່ງບໍ່ຖືກຕ້ອງ | ເວລາຈັດສົ່ງບໍ່ຖືກຕ້ອງ. |
| 110 | ເນື້ອໃນຂໍ້ຄວາມ/ຂໍ້ມູນຜູ້ໃຊ້ບໍ່ຖືກຕ້ອງ | ຂໍ້ມູນຜູ້ໃຊ້, ເຊັ່ນວ່າຂໍ້ຄວາມ SMS, ບໍ່ຖືກຕ້ອງ. |
| 111 | ຄວາມຍາວຂໍ້ຄວາມບໍ່ຖືກຕ້ອງ | ຄວາມຍາວຂອງຂໍ້ຄວາມ SMS ບໍ່ຖືກຕ້ອງ. |
| 112 | ສ່ວນຫົວຂໍ້ມູນຜູ້ໃຊ້ບໍ່ຖືກຕ້ອງ | ສ່ວນຫົວຂໍ້ມູນຜູ້ໃຊ້ບໍ່ຖືກຕ້ອງ. |
| 113 | ໂຄງການລະຫັດຂໍ້ມູນບໍ່ຖືກຕ້ອງ | DCS ບໍ່ຖືກຕ້ອງ. |
| 114 | ID ໂປຣໂຕຄໍບໍ່ຖືກຕ້ອງ | PID ບໍ່ຖືກຕ້ອງ. |
| 115 | ທຸງລາຍງານສະຖານະບໍ່ຖືກຕ້ອງ | ທຸງລາຍງານສະຖານະບໍ່ຖືກຕ້ອງ. |
| 116 | TON ບໍ່ຖືກຕ້ອງ | ຕົ້ນສະບັບ TON ບໍ່ຖືກຕ້ອງ. |
| 117 | ບໍ່ຖືກຕ້ອງ ຄampຊື່ | ຄ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) ເມື່ອນຳໃຊ້ໄດ້.
ຂ້າງລຸ່ມນີ້ແມ່ນຈໍານວນຂອງ examples ຂອງການແກ້ໄຂ:
| ສົ່ງທີ່ຢູ່ປາຍທາງ | ແກ້ໄຂທີ່ຢູ່ປາຍທາງ |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (ຫມາຍເລກພາສາຝຣັ່ງໄດ້ແປເປັນຫມາຍເລກ DOM-TOM) |
ນອກຈາກນັ້ນ, ມັນເປັນໄປໄດ້ທີ່ຈະອະນຸຍາດໃຫ້ເບີໂທລະສັບແຫ່ງຊາດສໍາລັບຕະຫຼາດທີ່ເລືອກ. ເມື່ອຄຸນສົມບັດນີ້ຖືກເປີດໃຊ້ງານທຸກຕົວເລກສາກົນສຳລັບຕະຫຼາດອື່ນຕ້ອງຖືກສົ່ງດ້ວຍເຄື່ອງໝາຍ `+' ເບື້ອງຕົ້ນເພື່ອຈຳແນກພວກມັນຈາກຕະຫຼາດທີ່ເລືອກ.
ຂ້າງລຸ່ມນີ້ແມ່ນຫຼາຍ examples ຂອງການແກ້ໄຂເຮັດໄດ້ໃນເວລາທີ່ການນໍາໃຊ້ສວີເດນ (ລະຫັດປະເທດ 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 ຫຼືການແຈ້ງການສົ່ງສໍາລັບຂໍ້ຄວາມ MT ທີ່ສົ່ງໄປ. ບົດລາຍງານເຫຼົ່ານີ້ຖືກກະຕຸ້ນຢູ່ໃນ Operator SMSC ເມື່ອຂໍ້ຄວາມ MT ຖືກສົ່ງໄປຫາຜູ້ບໍລິໂພກທີ່ຖືກເປົ້າຫມາຍຫຼືຖືກລຶບ, ຕົວຢ່າງ, ຫມົດອາຍຸຫຼື, ສໍາລັບເຫດຜົນບາງຢ່າງ, ບໍ່ສາມາດດໍາເນີນການໄດ້.
ພຽງແຕ່ສະຖານະການສຸດທ້າຍຂອງຂໍ້ຄວາມ SMS ໄດ້ຖືກລາຍງານໃຫ້ຜູ້ໃຫ້ບໍລິການ, ເຊັ່ນ, ສົ່ງຫຼືລຶບ. ມີພຽງແຕ່ຫນຶ່ງລາຍງານຕໍ່ຂໍ້ຄວາມ MT ແມ່ນຖືກສ້າງຂຶ້ນ. ດ້ວຍສະຖານະທີ່ຖືກລຶບ, ລະຫັດເຫດຜົນອາດຈະຖືກນຳໃຊ້. ລະຫັດເຫດຜົນນີ້ລະບຸເຫດຜົນຂອງຂໍ້ຄວາມ SMS ບໍ່ໄດ້ຖືກສົ່ງ.
ບົດລາຍງານຖືກສົ່ງຜ່ານ LINK Mobility ແລະສົ່ງໄປຫາຜູ້ໃຫ້ບໍລິການໂດຍໃຊ້ HTTP protocol.
ເພື່ອໃຫ້ໄດ້ຮັບບົດລາຍງານ, ຜູ້ໃຫ້ບໍລິການຕ້ອງການປະຕິບັດສໍາລັບ exampເປັນ Java Servlet ຫຼືໜ້າ ASP.NET. ທັງສອງໄດ້ຮັບການຮ້ອງຂໍ HTTP GET ຫຼື POST.
ພາລາມິເຕີ
ຄໍາຮ້ອງຂໍປະກອບມີຕົວກໍານົດການດັ່ງຕໍ່ໄປນີ້:
| ພາລາມິເຕີ | ປະເພດ | M/O/I* | ຄ່າເລີ່ມຕົ້ນ | ຄວາມຍາວສູງສຸດ | ລາຍລະອຽດ |
| MessageId | ສາຍ | M | – | 22 | ID ຂໍ້ຄວາມຂອງຂໍ້ຄວາມ MT ທີ່ບົດລາຍງານນີ້ສອດຄ່ອງກັບ. |
| ທີ່ຢູ່ປາຍທາງ | ສາຍ | M | – | 40 | MSISDN ຂອງຜູ້ບໍລິໂພກ, ເຊັ່ນທີ່ຢູ່ປາຍທາງຂອງຂໍ້ຄວາມ MT ຕົ້ນສະບັບ. |
| ລະຫັດສະຖານະ | ຈຳນວນເຕັມ | M | 1 | ລະຫັດສະຖານະຊີ້ບອກສະຖານະຂອງຂໍ້ຄວາມ MT. ລະຫັດສະຖານະທີ່ໃຊ້ໄດ້ຄື: 0 - ສົ່ງແລ້ວ 2 – ຖືກລົບ (ລະຫັດເຫດຜົນນໍາໃຊ້) |
|
| ເວລາamp | ສາຍ | M | – | 20 | ເວລາລະບຸເວລາທີ່ລາຍງານການຈັດສົ່ງໄດ້ຮັບໂດຍ LINK Mobility. ເຂດເວລາຂອງເວລາທີ່ສຸດamp ແມ່ນ CET ຫຼື CEST (ກັບເວລາຮ້ອນຕາມທີ່ກໍານົດສໍາລັບ EU). ຮູບແບບ: 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 (ກັບເວລາຮ້ອນຕາມທີ່ກໍານົດສໍາລັບ EU). ຮູບແບບ: yyyyMMdd HH:mm:ss. |
| ຂໍ້ຄວາມສະຖານະ | ສາຍ | O | – | 255 | ສະຖານທີ່ສໍາລັບຂໍ້ມູນເພີ່ມເຕີມຈາກຜູ້ປະຕິບັດງານ, ເຊັ່ນ: ຄໍາອະທິບາຍຂໍ້ຄວາມທີ່ຊັດເຈນຂອງສະຖານະພາບ / ເຫດຜົນ. ພຶດຕິກໍາອາດຈະແຕກຕ່າງກັນກັບການລວມຕົວຂອງຜູ້ປະກອບການ. |
| CorrelationId | ສາຍ | O | – | 100 | ID ຄວາມສຳພັນທີ່ສະໜອງໃຫ້ໃນ SendRequest ຫຼື SendTextRequest. |
| OperatorNetworkCode | ຈຳນວນເຕັມ | 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 ການຮັບຮູ້ຂອງຜູ້ໃຫ້ບໍລິການ
ຜູ້ໃຫ້ບໍລິການຄວນຮັບຮູ້ແຕ່ລະບົດລາຍງານການຈັດສົ່ງ. ການຮັບຮູ້ສາມາດເປັນບວກ, ie ບົດລາຍງານການຈັດສົ່ງສົບຜົນສໍາເລັດໄດ້ຮັບ, ຫຼືທາງລົບ, ie ຄວາມລົ້ມເຫຼວ.
ກະລຸນາສັງເກດ: LINK Mobility ມີເວລາອ່ານສໍາລັບການຮັບຮູ້ 30 ວິນາທີສໍາລັບການລາຍງານການຈັດສົ່ງ. ການໝົດເວລາຈະກະຕຸ້ນໃຫ້ມີການສົ່ງຄືນການສົ່ງຄືນ (ຖ້າເປີດການລອງອີກຄັ້ງ) ຫຼືການຍົກເລີກການຈັດສົ່ງ (ຖ້າປິດການໃຊ້ງານຄືນໃໝ່). ນີ້ຫມາຍຄວາມວ່າຄໍາຮ້ອງສະຫມັກຂອງຜູ້ໃຫ້ບໍລິການຕ້ອງຮັບປະກັນເວລາຕອບສະຫນອງໄວ, ໂດຍສະເພາະໃນລະຫວ່າງການໂຫຼດສູງ.
ຂໍແນະນຳໃຫ້ຮັບຮູ້ບົດລາຍງານການຈັດສົ່ງຕໍ່ LINK Mobility ກ່ອນທີ່ຈະປະມວນຜົນມັນ.
ກົດລະບຽບສໍາລັບການຮັບຮູ້ໃນທາງບວກແລະທາງລົບແມ່ນໄດ້ອະທິບາຍດັ່ງຕໍ່ໄປນີ້:
ການຮັບຮູ້ໃນທາງບວກ, ACK, ບົດລາຍງານການຈັດສົ່ງທີ່ສົ່ງໃຫ້:
HTTP 200 ລະຫັດຕອບສະຫນອງໃນການປະສົມກັບເນື້ອໃນຮູບແບບ XML ດັ່ງຕໍ່ໄປນີ້:
ການຮັບຮູ້ທາງລົບ, NAK, ບົດລາຍງານການຈັດສົ່ງບໍ່ໄດ້ສົ່ງ:
ຄໍາຕອບໃດໆນອກເຫນືອຈາກການຮັບຮູ້ໃນທາງບວກ, ສໍາລັບການຍົກຕົວຢ່າງampດັ່ງນັ້ນ, ການຮັບຮູ້ທາງລົບແມ່ນເກີດຂື້ນໂດຍລະຫັດຂໍ້ຜິດພາດ HTTP ຫຼືເນື້ອຫາ XML ຕໍ່ໄປນີ້:
ເນື້ອຫາ XML ສາມາດຖືກນໍາໃຊ້ເພື່ອຄວບຄຸມກົນໄກການພະຍາຍາມ LINK Mobility ຄືນໃໝ່. A NAK ຈະເຮັດໃຫ້ເກີດຄວາມພະຍາຍາມອີກຄັ້ງ, ຖ້າເປີດໃຊ້. ສໍາລັບຜູ້ໃຫ້ບໍລິການທີ່ບໍ່ໄດ້ຕັ້ງຄ່າສໍາລັບກົນໄກການລອງໃຫມ່, ເນື້ອຫາ XML ແມ່ນທາງເລືອກ.
ຂ້າງລຸ່ມນີ້ແມ່ນການຮ້ອງຂໍ HTTP POST ແລະການຕອບສະຫນອງ exampບົດລາຍງານການຈັດສົ່ງທີ່ສົ່ງໃຫ້ຜູ້ໃຫ້ບໍລິການ:
ຄຳຮ້ອງຂໍ HTTP:
POST /context/app HTTP/1.1
ເນື້ອຫາປະເພດ: ຄຳ ຮ້ອງສະ ໝັກ / x-www-form-urlencoded;charset=utf-8
ເຈົ້າພາບ: server:port
ຄວາມຍາວເນື້ອໃນ: 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 ສາມາດດໍາເນີນການພະຍາຍາມໃຫມ່ສໍາລັບຄວາມລົ້ມເຫລວ, ie ບໍ່ໄດ້ຮັບການຍອມຮັບ, ການຈັດສົ່ງລາຍງານການຈັດສົ່ງ. ຜູ້ໃຫ້ບໍລິການສາມາດເລືອກພຶດຕິກຳການລອງໃໝ່ທີ່ຕ້ອງການໄດ້:
ບໍ່ມີການລອງໃໝ່ (ຄ່າເລີ່ມຕົ້ນ) – ຂໍ້ຄວາມຈະຖືກຍົກເລີກຫາກຄວາມພະຍາຍາມເຊື່ອມຕໍ່ລົ້ມເຫລວ, ອ່ານໝົດເວລາ ຫຼືສໍາລັບລະຫັດຂໍ້ຜິດພາດ HTTP.
ລອງໃໝ່ - ຂໍ້ຄວາມຈະຖືກສົ່ງຄືນສໍາລັບປະເພດຂອງບັນຫາການເຊື່ອມຕໍ່, ອ່ານຫມົດເວລາ, ຫຼືການຮັບຮູ້ທາງລົບ.
ເມື່ອການລອງໃຫມ່ສໍາລັບ NAK ຖືກເປີດໃຊ້, ມັນເປັນສິ່ງສໍາຄັນທີ່ຈະເຂົ້າໃຈວ່າສະຖານະການໃດທີ່ຈະສ້າງຄວາມພະຍາຍາມໃຫມ່ຈາກ LINK Mobility ແລະວິທີການພະຍາຍາມໃຫມ່ເຮັດວຽກ. ຜູ້ໃຫ້ບໍລິການແຕ່ລະຄົນມີຄິວການລອງໃຫມ່ຂອງຕົນເອງ, ບ່ອນທີ່ຂໍ້ຄວາມຖືກຈັດຮຽງຕາມເວລາຂໍ້ຄວາມamp. Link Mobility ພະຍາຍາມສົ່ງຂໍ້ຄວາມເກົ່າກ່ອນສະເໝີ, ເຖິງແມ່ນວ່າການສັ່ງຂໍ້ຄວາມແຕ່ລະອັນທີ່ສົ່ງໃຫ້ຜູ້ໃຫ້ບໍລິການຈະບໍ່ຮັບປະກັນ. ເຫດຜົນຕົ້ນຕໍທີ່ຂໍ້ຄວາມຖືກຍົກເລີກຈາກຄິວລອງໃຫມ່ແມ່ນຫນຶ່ງໃນສອງເຫດຜົນ: ຂໍ້ຄວາມ TTL ຈະຫມົດອາຍຸຫຼື (ທາງທິດສະດີ) ຄິວລອງໃຫມ່ຈະເຕັມ. TTL ແມ່ນຜູ້ປະຕິບັດການແລະບັນຊີຂຶ້ນກັບ, ie, ສາມາດແຕກຕ່າງກັນໄປຕາມຜູ້ປະຕິບັດການແລະຫຼືປະເພດຂໍ້ຄວາມ, ຕົວຢ່າງ, SMS ທີ່ນິຍົມຫຼືຂໍ້ຄວາມ SMS ອັດຕາມາດຕະຖານ.
ຜູ້ໃຫ້ບໍລິການທີ່ເປີດໃຊ້ການພະຍາຍາມອີກຄັ້ງຈະຕ້ອງກວດເບິ່ງ ID ສະເພາະຂອງຂໍ້ຄວາມ MT ເພື່ອຮັບປະກັນວ່າຂໍ້ຄວາມດັ່ງກ່າວຍັງບໍ່ທັນໄດ້ຮັບເທື່ອ.
ມັນເປັນສິ່ງສໍາຄັນສໍາລັບຜູ້ໃຫ້ບໍລິການທີ່ຈະປະຕິບັດຕາມກົດລະບຽບງ່າຍໆເຫຼົ່ານີ້ເມື່ອມີຂໍ້ຜິດພາດເກີດຂື້ນໃນລະຫວ່າງການດໍາເນີນການລາຍງານການຈັດສົ່ງຖ້າເຫດຜົນຂອງຄວາມຜິດພາດແມ່ນ: ຊົ່ວຄາວ, ຕົວຢ່າງເຊັ່ນຖານຂໍ້ມູນບໍ່ມີ, NAK ຄວນຖືກສົ່ງຄືນ. LINK Mobility ຈະສົ່ງຂໍ້ຄວາມຄືນໃໝ່.
ການພະຍາຍາມແບບຖາວອນ ແລະ ພະຍາຍາມຄືນໃໝ່ມີແນວໂນ້ມທີ່ຈະເຮັດໃຫ້ເກີດບັນຫາແບບດຽວກັນ, ACK ຄວນຖືກສົ່ງຄືນ. ຕົວຢ່າງample, ໃນເວລາທີ່ຂໍ້ຄວາມບໍ່ສາມາດຖືກວິເຄາະຢ່າງຖືກຕ້ອງຫຼືເຮັດໃຫ້ເກີດຄວາມຜິດພາດ runtime ທີ່ບໍ່ຄາດຄິດ.
ການປະຕິບັດຕາມຄວາມສອດຄ່ອງຈະຮັບປະກັນວ່າບໍ່ມີການຂັດຂວາງຫຼືການເຊື່ອມໂຊມຂອງສານທີ່ເກີດຂື້ນເນື່ອງຈາກບົດລາຍງານການຈັດສົ່ງຖືກສົ່ງຄືນເລື້ອຍໆ.
10. ຄໍາແນະນໍາການຈັດຕັ້ງປະຕິບັດ
1. ມັນເປັນໄປໄດ້ທີ່ຈະໃຊ້ຂອງທ່ານ web browser ເພື່ອສົ່ງຄໍາຮ້ອງຂໍໄປຫາ API. ນີ້ເຮັດໃຫ້ມັນງ່າຍຫຼາຍທີ່ຈະຄົ້ນຫາແລະປະເມີນການບໍລິການໂດຍບໍ່ມີເຄື່ອງມືພັດທະນາໃດໆ.
2. Chrome ຫຼື Firefox ແມ່ນແນະນໍາຮ່ວມກັນກັບສ່ວນຂະຫຍາຍເຊັ່ນ JSONView ເພື່ອສະແດງ JSON ທີ່ມີຮູບແບບທີ່ສວຍງາມ.
3. ພວກເຮົາໄດ້ໃຊ້ SoapUI ສໍາລັບການທົດສອບ POST, Basic Authentication ແລະສໍາລັບການກວດສອບຄໍາຮ້ອງຂໍ HTTP ດິບແລະຂໍ້ຄວາມຕອບສະຫນອງ.
4. ຄURL ເຄື່ອງມືທີ່ເປັນປະໂຫຍດສໍາລັບການສົ່ງຄໍາຮ້ອງຂໍ POST ດ້ວຍການພິສູດຢືນຢັນພື້ນຖານ. ເບິ່ງ example ຂ້າງລຸ່ມນີ້.
curl ໂພສ \
-H “ປະເພດເນື້ອຫາ: application/x-www-form-urlເຂົ້າລະຫັດ” \
-H “ການອະນຸຍາດ: ພື້ນຖານ am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–data “destinationAddress=46123456789&messageText=ສະບາຍດີ+ໂລກ%21”
_______________
ການຫັນປ່ຽນການສື່ສານສ່ວນບຸກຄົນ
ເອກະສານ / ຊັບພະຍາກອນ
 |
LINK ຄູ່ມືການປະຕິບັດການເຄື່ອນທີ່ REST API SMS [pdf] ຄູ່ມືຜູ້ໃຊ້ ຄູ່ມືການປະຕິບັດການເຄື່ອນໄຫວ REST API SMS, ການເຄື່ອນໄຫວ, ຄູ່ມືການປະຕິບັດ REST API SMS, REST API SMS, API SMS, SMS |
