ការណែនាំអំពីការអនុវត្តការចល័ត LINK REST API SMS
LINK Mobility ផ្តល់សេវាកម្មសម្រាប់ការបញ្ជូនសារ ការទូទាត់ខ្នាតតូច និងសេវាកម្មផ្អែកលើទីតាំង។ វេទិកានេះដើរតួជាអ្នកទទួលមាតិកាស្លាកពណ៌សថ្លា និងរ៉ោតទ័រប្រតិបត្តិការរវាងអ្នកផ្តល់សេវា និងប្រតិបត្តិករ។
LINK Mobility ផ្តល់នូវ RESTful API ដែលអាចត្រូវបានប្រើដើម្បីចូលប្រើសេវាកម្ម 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. មុខងារលើសview
ប្រព័ន្ធ LINK Mobility ផ្តល់នូវមុខងារជាមូលដ្ឋានខាងក្រោមសម្រាប់សារ SMS៖
ការផ្ញើសារ SMS ដែលត្រូវបានបញ្ចប់តាមទូរសព្ទចល័ត (MT) ដូចជាអត្ថបទ ឬប្រព័ន្ធគោលពីរ (ឧទាហរណ៍ WAP Push) បុព្វលាភ និងសារអត្រាស្តង់ដារ។
ការទទួលរបាយការណ៍ដឹកជញ្ជូនសម្រាប់សារ MT ដែលបានបញ្ជូន។
ការទទួលសារ SMS ដែលមានប្រភពដើមតាមទូរស័ព្ទ (MO) អត្រាបុព្វលាភ និងអត្រាស្តង់ដារ។
SMS REST API ត្រូវបានឧទ្ទិសដល់ការផ្ញើសារ MT SMS អត្រាស្តង់ដារ។
API ផ្ញើសារ SMS ទាំងអស់ដោយអសមកាល ដោយបើកមុខងារដូចជា៖
“Fire-and-forget” – អ្នកផ្តល់សេវាចង់មានពេលវេលាឆ្លើយតបដែលអាចព្យាករណ៍បានបន្ថែមទៀត ហើយមិនចង់រង់ចាំលទ្ធផលពីប្រតិបត្តិករនោះទេ។
សាកល្បងមុខងារម្តងទៀត – LINK Mobility នឹងផ្ញើសារឡើងវិញ ប្រសិនបើប្រតិបត្តិករមានបញ្ហាបណ្តោះអាសន្ន។
2.1 ការផ្ញើសារ SMS
អ្នកផ្តល់សេវា Netsize Consumer
- ផ្ញើសារ MT
- ត្រឡប់លេខសម្គាល់សារ
- បញ្ជូនសារ SMS
- ផ្តល់របាយការណ៍ដឹកជញ្ជូន
- ផ្ញើរបាយការណ៍ដឹកជញ្ជូន
លំហូរជាមូលដ្ឋានសម្រាប់ការផ្ញើសារ SMS ត្រូវបានពិពណ៌នាដូចខាងក្រោម:
អ្នកផ្តល់សេវាធ្វើសំណើដើម្បីផ្ញើសារ SMS ទៅកាន់អ្នកទទួលតាមរយៈប្រព័ន្ធ LINK Mobility ។
លេខសម្គាល់សារត្រូវបានបញ្ជូនត្រឡប់ទៅអ្នកផ្តល់សេវាវិញ។ លេខសម្គាល់នេះអាចត្រូវបានប្រើសម្រាប់ឧទាហរណ៍ទំនាក់ទំនងសារជាមួយរបាយការណ៍ចែកចាយត្រឹមត្រូវ។
LINK Mobility គ្រប់គ្រងការបញ្ជូន និងបញ្ជូនសារ SMS ទៅកាន់អ្នកប្រើប្រាស់ដែលមានអាសយដ្ឋាន។
របាយការណ៍ដឹកជញ្ជូនត្រូវបានបង្កឡើង ឧទាហរណ៍នៅពេលដែលសារ 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/ផ្ញើ |
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 ។ ម៉ាស៊ីនភ្ញៀវបង្កើតវាលបឋមកថាដូចដែលបានពិពណ៌នានៅទីនេះ៖
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 | MSISDN ដែលសារ SMS គួរតែត្រូវបានផ្ញើទៅ ដោយចាប់ផ្តើមដោយលេខកូដប្រទេស។ ឧampលេខ៖ 46123456789 ។ សម្រាប់ទីផ្សារមួយចំនួន (ដែលអតិថិជន MSISDN ត្រូវតែមានការភ័ន្តច្រឡំ) តម្លៃនេះក៏អាចជាលេខក្លែងក្លាយដែលដាក់បុព្វបទជាមួយ “#” ផងដែរ។ |
| អត្ថបទសារ | 1600 | ខ្លឹមសារនៃសារ SMS ។ |
6.3 ប៉ារ៉ាម៉ែត្រសំណើជាជម្រើស (សម្រាប់ការប្រើប្រាស់កម្រិតខ្ពស់)
| ឈ្មោះ | ប្រវែងអតិបរមា | ការពិពណ៌នា |
| អាស័យដ្ឋានដើម | 16 | អាសយដ្ឋានដើមសម្រាប់សារ SMS ចេញ។ ប្រភេទនៃអាសយដ្ឋានប្រភពដើមត្រូវបានកំណត់ដោយប៉ារ៉ាម៉ែត្រដើម TON ។ លេខខ្លី ប្រវែងអតិបរមាគឺ 16។ អ្នកផ្ញើលេខអាល់ហ្វាត្រូវបានកំណត់ចំពោះអក្ខរក្រមលំនាំដើម GSM ដែលមានប្រវែងអតិបរមា 11 តួអក្សរ។ ប្រវែងអតិបរិមារបស់អ្នកផ្ញើ MSISDN គឺ 15 (ដោយប្រើទម្រង់ដូចគ្នាទៅនឹងធាតុអាសយដ្ឋានគោលដៅ)។ អាចត្រូវបានលុបចោលនៅពេលដែលប្រភពដើមអាសយដ្ឋាន និងប្រភពដើមTON ត្រូវបានជ្រើសរើសដោយប្រព័ន្ធ។ មុខងារនេះគឺអាស្រ័យលើទីផ្សារ និងការកំណត់រចនាសម្ព័ន្ធ។ ឥរិយាបថអាចប្រែប្រួលជាមួយនឹងការរួមបញ្ចូលប្រតិបត្តិករ។ |
| អ្នកបង្កើតTON | 1 | ប្រភេទនៃអាសយដ្ឋានប្រភពដើម (TON)៖ 0 - លេខខ្លី 1 – លេខអាល់ហ្វា (ប្រវែងអតិបរមា 11) 2 – MSISDN អាចត្រូវបានលុបចោលនៅពេលដែលប្រភពដើមអាសយដ្ឋាន និងប្រភពដើមTON នឹងត្រូវបានជ្រើសរើសដោយប្រព័ន្ធ។ មុខងារនេះគឺអាស្រ័យលើទីផ្សារ និងការកំណត់រចនាសម្ព័ន្ធ។ ឥរិយាបថអាចប្រែប្រួលជាមួយនឹងការរួមបញ្ចូលប្រតិបត្តិករ។ |
| userDataHeader | 280 | បឋមកថាទិន្នន័យអ្នកប្រើប្រាស់រួមជាមួយនឹងទិន្នន័យអ្នកប្រើប្រាស់អាចមានរហូតដល់ 140 ពោលគឺ 280 នៅពេលអ៊ិនកូដគោលដប់ប្រាំមួយ octets ។ ប៉ារ៉ាម៉ែត្រនេះតែងតែត្រូវបានអ៊ិនកូដគោលដប់ប្រាំមួយ។ |
| DCS | 3 | គ្រោងការណ៍នៃការសរសេរកូដទិន្នន័យ។ ឥរិយាបថអាចប្រែប្រួលជាមួយនឹងការរួមបញ្ចូលប្រតិបត្តិករ។ |
| PID | 3 | លេខសម្គាល់ពិធីការ។ ឥរិយាបថអាចប្រែប្រួលជាមួយនឹងការរួមបញ្ចូលប្រតិបត្តិករ។ |
| RelativeValidityTime | 6 | រយៈពេលសុពលភាពដែលទាក់ទងគិតជាវិនាទី (ទាក់ទងទៅនឹងពេលវេលាសម្រាប់ការបញ្ជូនទៅកាន់ LINK Mobility)។ តម្លៃអតិបរមាគឺ 604800 (7 ថ្ងៃ) ហើយលំនាំដើមគឺ 48 ម៉ោង។ ឥរិយាបថអាចប្រែប្រួលជាមួយនឹងការរួមបញ្ចូលប្រតិបត្តិករ។ |
| ពេលវេលាដឹកជញ្ជូន | 20 | ពេលវេលាamp នៅពេលដែលសារ SMS គួរតែត្រូវបានបញ្ជូន (ពេលវេលាដឹកជញ្ជូនពន្យារពេល) ។ សូមមើលផ្នែកនៅលើទម្រង់កាលបរិច្ឆេទ។ |
| ស្ថានភាពរបាយការណ៍ទង់ | 1 | បញ្ជូនសំណើររបាយការណ៍៖ 0 - គ្មានរបាយការណ៍ចែកចាយ (លំនាំដើម) 1 - របាយការណ៍ដឹកជញ្ជូនបានស្នើសុំ 9 – របាយការណ៍បញ្ជូនម៉ាស៊ីនមេបានស្នើសុំ (LINK Mobility មិនបញ្ជូនរបាយការណ៍ទៅអ្នកផ្តល់សេវាទេ ប៉ុន្តែធ្វើឱ្យវាមាននៅក្នុងរបាយការណ៍។ល។) |
| campឈ្មោះ | 50 | ប្រតិបត្តិការ LINK ចល័តគឺ tagged ជាមួយឈ្មោះនេះ។ វាត្រូវបានប្រើដើម្បីធ្វើប្រតិបត្តិការជាក្រុមនៅក្នុងរបាយការណ៍ Link Mobility។ |
| maxConcatenatedMessages | 1 | តម្លៃរវាង 1 និង 10 ដែលកំណត់ចំនួនសារដែលភ្ជាប់គ្នាដែលត្រូវបានអនុញ្ញាត។ លំនាំដើមគឺ 3 ។ |
| លេខសម្គាល់ទំនាក់ទំនង | 100 | លេខសម្គាល់ដែលផ្តល់ដោយអ្នកផ្តល់សេវាដែលនឹងត្រូវបានបន្ទរនៅក្នុងរបាយការណ៍ដឹកជញ្ជូន។ |
| ឈ្មោះអ្នកប្រើប្រាស់ | 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 ប្រកាស
ខ្សែអក្សរសំណួរដែលបានអ៊ិនកូដត្រូវបានដាក់ស្នើនៅក្នុងតួសារសំណើ HTTP។ ប្រភេទមាតិកាគឺកម្មវិធី/x-www-form-urlបានអ៊ិនកូដ។
ប្រកាស https://europe.ipx.com/restapi/v1/sms/send
ម៉ាស៊ីន៖ europe.ipx.com
ប្រភេទមាតិកា៖ ពាក្យសុំ / x-www-form-urlបានអ៊ិនកូដ
ការអនុញ្ញាត៖ មូលដ្ឋាន am9objpjaGFuZ2VtZSA=
ប្រវែងមាតិកា៖ ៧០
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 យល់ព្រមសម្រាប់សំណើដែលបានដំណើរការ។ តួសារមានប៉ារ៉ាម៉ែត្រឆ្លើយតបកូដដែលត្រូវបានប្រើដើម្បីកំណត់លទ្ធផលពិតប្រាកដ។
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 ដំណើរការសំណើ។ (សូមមើលផ្នែកទម្រង់កាលបរិច្ឆេទ/ពេលវេលា)។ |
| លេខសម្គាល់ដាន | 36 | ភ្ជាប់ឧបករណ៍កំណត់អត្តសញ្ញាណខាងក្នុងចល័ត។ ប្រើសម្រាប់ជំនួយ និងដោះស្រាយបញ្ហា។ |
| លេខសម្គាល់សារ | 10 x 36 | អារេនៃ LINK Mobility លេខសម្គាល់សារតែមួយគត់សម្រាប់សារជោគជ័យនីមួយៗ (លេខសម្គាល់សារជាច្រើនត្រូវបានបញ្ជូនមកវិញប្រសិនបើសារត្រូវបានភ្ជាប់) ។ លុបចោលក្នុងករណីបរាជ័យ។ |
៣.២ ឧample ការឆ្លើយតប
ជោគជ័យ
HTTP/1.1 200 យល់ព្រម
ប្រភេទមាតិកា៖ application/json
ប្រវែងមាតិកា៖ ៧០
កាលបរិច្ឆេទ៖ 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”,
“លេខសម្គាល់ដាន“:”f678d30879fd4adc25f2”,
“លេខសម្គាល់សារ“:[“1-4850879008”] }
បរាជ័យ
HTTP/1.1 200 យល់ព្រម
ប្រភេទមាតិកា៖ application/json
ប្រវែងមាតិកា៖ ៧០
កាលបរិច្ឆេទ៖ 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
ប្រវែងមាតិកា៖ ៧០
កាលបរិច្ឆេទ៖ 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”,
“លេខសម្គាល់ដាន“:”f678d30879fd4adc25f2”,
“លេខសម្គាល់សារ“:[“1-4850879008”] }
បរាជ័យ
HTTP/1.1 200 យល់ព្រម
ប្រភេទមាតិកា៖ application/json
ប្រវែងមាតិកា៖ ៧០
កាលបរិច្ឆេទ៖ 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 | អាសយដ្ឋានប្រភពដើមអាល់ហ្វាមិនត្រូវបានគាំទ្រដោយគណនីទេ។ | អាសយដ្ឋានប្រភពដើមអាល់ហ្វាមិនត្រូវបានគាំទ្រដោយគណនីទេ។ |
| 8 | អាសយដ្ឋានប្រភពដើម MSISDN មិនត្រូវបានគាំទ្រទេ។ | អាសយដ្ឋានប្រភពដើម MSISDN មិនត្រូវបានគាំទ្រទេ។ |
| 9 | ការពង្រីក GSM មិនត្រូវបានគាំទ្រទេ។ | ការពង្រីក GSM មិនត្រូវបានគាំទ្រទេ។ |
| 10 | មិនគាំទ្រយូនីកូដទេ។ | មិនគាំទ្រយូនីកូដទេ។ |
| 11 | របាយការណ៍ស្ថានភាពមិនត្រូវបានគាំទ្រទេ។ | របាយការណ៍ស្ថានភាពមិនត្រូវបានគាំទ្រទេ។ |
| 12 | សមត្ថភាពដែលត្រូវការមិនត្រូវបានគាំទ្រទេ។ | សមត្ថភាពដែលត្រូវការ (ក្រៅពីខាងលើ) សម្រាប់ការផ្ញើសារមិនត្រូវបានគាំទ្រទេ។ |
| 13 | អត្រាបិទផ្លូវអតិបរមារបស់អ្នកផ្តល់សេវាមាតិកាគឺលើស | អ្នកផ្តល់សេវាកំពុងផ្ញើសារ SMS ទៅ LINK Mobility លឿនពេក។ |
| 14 | លេខសម្គាល់ពិធីការមិនត្រូវបានគាំទ្រដោយគណនីទេ។ | លេខសម្គាល់ពិធីការមិនត្រូវបានគាំទ្រទេ។ |
| 15 | លើសដែនកំណត់នៃការភ្ជាប់សារ | ចំនួនសារដែលភ្ជាប់គ្នាលើសពីចំនួនអតិបរមាដែលបានស្នើសុំ។ |
| 16 | មិនអាចបញ្ជូនសារបានទេ។ | LINK Mobility មិនអាចបញ្ជូនសារបានទេ។ |
| 17 | រយៈពេលហាមឃាត់ | មិនត្រូវបានអនុញ្ញាតឱ្យផ្ញើសារក្នុងអំឡុងពេលនោះទេ។ |
| 18 | សមតុល្យទាបពេកនៅលើគណនីអ្នកផ្តល់សេវា | ក្រុមហ៊ុនផ្តល់សេវាត្រូវបានរារាំងដោយសារតែសមតុល្យទាបពេក |
| 50 | ជោគជ័យមួយផ្នែក | ជោគជ័យមួយផ្នែកនៅពេលផ្ញើសារ SMS ទៅកាន់អ្នកទទួលច្រើន។ |
| 99 | កំហុសម៉ាស៊ីនមេខាងក្នុង | កំហុសនៃតំណភ្ជាប់ចល័តផ្សេងទៀត សូមទាក់ទងផ្នែកជំនួយការចល័ត LINK សម្រាប់ព័ត៌មានបន្ថែម។ |
| 100 | អាសយដ្ឋានគោលដៅមិនត្រឹមត្រូវ | អាសយដ្ឋានគោលដៅ (MSISDN ឬឈ្មោះក្លែងក្លាយ) មិនត្រឹមត្រូវទេ។ |
| 102 | លេខសម្គាល់ដែលបានយោងមិនត្រឹមត្រូវ (បានភ្ជាប់) | លេខសម្គាល់ឯកសារយោងមិនត្រឹមត្រូវទេ ប្រហែលជាលេខសម្គាល់ឯកសារយោងត្រូវបានប្រើរួចហើយ ចាស់ពេក ឬមិនស្គាល់។ |
| 103 | ឈ្មោះគណនីមិនត្រឹមត្រូវ | ឈ្មោះគណនីមិនត្រឹមត្រូវទេ។ |
| 105 | ទិន្នន័យមេតាសេវាកម្មមិនត្រឹមត្រូវ | ទិន្នន័យមេតានៃសេវាកម្មមិនត្រឹមត្រូវទេ។ |
| 106 | អាសយដ្ឋានប្រភពដើមមិនត្រឹមត្រូវ | អាសយដ្ឋានប្រភពដើមមិនត្រឹមត្រូវទេ។ |
| 107 | អាសយដ្ឋានប្រភពដើមអក្សរក្រមលេខមិនត្រឹមត្រូវ | អាសយដ្ឋានប្រភពដើមអក្សរក្រមលេខមិនត្រឹមត្រូវទេ។ |
| 108 | ពេលវេលាសុពលភាពមិនត្រឹមត្រូវ | ពេលវេលាសុពលភាពគឺមិនត្រឹមត្រូវទេ។ |
| 109 | ពេលវេលាដឹកជញ្ជូនមិនត្រឹមត្រូវ | ពេលវេលាដឹកជញ្ជូនមិនត្រឹមត្រូវទេ។ |
| 110 | ខ្លឹមសារសារមិនត្រឹមត្រូវ/ទិន្នន័យអ្នកប្រើប្រាស់ | ទិន្នន័យអ្នកប្រើប្រាស់ ពោលគឺសារ SMS គឺមិនត្រឹមត្រូវទេ។ |
| 111 | ប្រវែងសារមិនត្រឹមត្រូវ | ប្រវែងសារ SMS មិនត្រឹមត្រូវទេ។ |
| 112 | បឋមកថាទិន្នន័យអ្នកប្រើប្រាស់មិនត្រឹមត្រូវ | បឋមកថាទិន្នន័យអ្នកប្រើប្រាស់មិនត្រឹមត្រូវទេ។ |
| 113 | គ្រោងការណ៍ការសរសេរកូដទិន្នន័យមិនត្រឹមត្រូវ | DCS មិនត្រឹមត្រូវទេ។ |
| 114 | លេខសម្គាល់ពិធីការមិនត្រឹមត្រូវ | PID មិនត្រឹមត្រូវទេ។ |
| 115 | ទង់របាយការណ៍ស្ថានភាពមិនត្រឹមត្រូវ | ទង់របាយការណ៍ស្ថានភាពមិនត្រឹមត្រូវទេ។ |
| 116 | TON មិនត្រឹមត្រូវ | អ្នកបង្កើត TON មិនត្រឹមត្រូវទេ។ |
| 117 | មិនត្រឹមត្រូវ គampឈ្មោះសញ្ញា | គampឈ្មោះសញ្ញាមិនត្រឹមត្រូវ។ |
| 120 | ដែនកំណត់មិនត្រឹមត្រូវសម្រាប់ចំនួនអតិបរមានៃសារដែលភ្ជាប់គ្នា។ | ចំនួនអតិបរមានៃសារដែលភ្ជាប់គ្នាគឺមិនត្រឹមត្រូវ។ |
| 121 | អាសយដ្ឋានប្រភពដើម mssdn មិនត្រឹមត្រូវ | អាសយដ្ឋានប្រភពដើម MSISDN មិនត្រឹមត្រូវទេ។ |
| 122 | លេខសម្គាល់ទំនាក់ទំនងមិនត្រឹមត្រូវ | លេខសម្គាល់ទំនាក់ទំនងមិនត្រឹមត្រូវ។ |
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 |
| ០១៤៨៦០៧៤-០០៤ | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (លេខបារាំងបកប្រែទៅជាលេខ DOM-TOM) |
លើសពីនេះ វាអាចទៅរួចក្នុងការអនុញ្ញាតឱ្យលេខទូរស័ព្ទជាតិសម្រាប់ទីផ្សារដែលបានជ្រើសរើស។ នៅពេលដែលមុខងារនេះត្រូវបានបើក លេខអន្តរជាតិណាមួយសម្រាប់ទីផ្សារផ្សេងទៀតត្រូវតែផ្ញើជាមួយសញ្ញា `+' ដំបូង ដើម្បីសម្គាល់ពួកវាពីទីផ្សារដែលបានជ្រើសរើស។
ខាងក្រោមនេះគឺជាអតីតមួយចំនួនampការកែតម្រូវបានធ្វើឡើងនៅពេលប្រើស៊ុយអែត (លេខកូដប្រទេស 46) ជាទីផ្សារលំនាំដើមសម្រាប់លេខជាតិ។
| អាសយដ្ឋានគោលដៅដែលបានបញ្ជូន | អាសយដ្ឋានគោលដៅដែលបានកែ |
| 0702233445 | 46702233445 |
| ៩០១-១០០ ១៣៣ | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | មិនត្រឹមត្រូវទេ ដោយសារសញ្ញា '+' បាត់ |
ចំណាំថា MSISDN ដែលត្រូវបានកែដំរូវនឹងត្រូវបានប្រើដោយ LINK Mobility ហើយវានឹងត្រលប់មកវិញនៅក្នុងរបាយការណ៍ចែកចាយ។
សូមទាក់ទងផ្នែកជំនួយការចល័ត LINK សម្រាប់ព័ត៌មានបន្ថែម។
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 ។
ដើម្បីទទួលបានរបាយការណ៍ អ្នកផ្តល់សេវាត្រូវអនុវត្តសម្រាប់ ឧampជា Java Servlet ឬទំព័រ ASP.NET ។ ទាំងពីរទទួលបានសំណើ HTTP GET ឬ POST ។
ប៉ារ៉ាម៉ែត្រ
សំណើរួមមានប៉ារ៉ាម៉ែត្រដូចខាងក្រោមៈ
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | M/O/I* | តម្លៃលំនាំដើម | ប្រវែងអតិបរមា | ការពិពណ៌នា |
| លេខសម្គាល់សារ | ខ្សែអក្សរ | M | – | 22 | លេខសម្គាល់សារនៃសារ 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 - លើសអង្គចងចាំទូរស័ព្ទ ឥរិយាបថអាចប្រែប្រួលជាមួយនឹងការរួមបញ្ចូលប្រតិបត្តិករ។ |
| ប្រតិបត្តិករ TimeStamp | ខ្សែអក្សរ | O | – | 20 | ពេលវេលាដែលបង្ហាញពីពេលដែលរបាយការណ៍ត្រូវបានកេះនៅក្នុង SMSC របស់ប្រតិបត្តិករ (ប្រសិនបើផ្តល់ដោយប្រតិបត្តិករ)។ តំបន់ពេលវេលានៃពេលវេលាបំផុត។amp គឺ CET ឬ CEST (ជាមួយនឹងពេលវេលារដូវក្តៅ ដូចដែលបានកំណត់សម្រាប់ EU)។ ទម្រង់៖ yyyyMMdd HH:mm:ss ។ |
| អត្ថបទស្ថានភាព | ខ្សែអក្សរ | O | – | 255 | កន្លែងដាក់សម្រាប់ព័ត៌មានបន្ថែមពីប្រតិបត្តិករ ឧ. ការពិពណ៌នាអត្ថបទច្បាស់លាស់អំពីស្ថានភាព/ហេតុផល។ ឥរិយាបថអាចប្រែប្រួលជាមួយនឹងការរួមបញ្ចូលប្រតិបត្តិករ។ |
| លេខសម្គាល់ទំនាក់ទំនង | ខ្សែអក្សរ | O | – | 100 | លេខសម្គាល់ទំនាក់ទំនងដែលបានផ្តល់នៅក្នុង SendRequest ឬ SendTextRequest។ |
| លេខកូដប្រតិបត្តិករបណ្តាញ | ចំនួនគត់ | O | – | 6 | លេខកូដបណ្តាញទូរស័ព្ទចល័ត (MCC + MNC) របស់ប្រតិបត្តិករ។ |
* M = កាតព្វកិច្ច, O = ស្រេចចិត្ត, ខ្ញុំ = មិនអើពើ។
អ្នកផ្តល់សេវាត្រូវផ្តល់ LINK Mobility ជាមួយនឹងគោលដៅ URL សម្រាប់របាយការណ៍ចែកចាយ (ជាជម្រើសរួមទាំងព័ត៌មានបញ្ជាក់អត្តសញ្ញាណសម្រាប់ការផ្ទៀងផ្ទាត់មូលដ្ឋាន HTTP)។ អ្នកផ្តល់សេវាអាចជ្រើសរើសវិធីសាស្ត្រ HTTP ដែលពេញចិត្តដើម្បីប្រើ៖
HTTP POST (បានណែនាំ)
HTTP GET ។
Exampដោយប្រើ HTTP GET (ចែកចាយដោយជោគជ័យ)៖
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example ដោយប្រើ HTTP GET (មិនត្រូវបានបញ្ជូនទេ ប្រតិបត្តិករបានផ្គត់ផ្គង់ពេលវេលាច្រើនបំផុតamp សម្រាប់ព្រឹត្តិការណ៍)៖
ប៉ារ៉ាម៉ែត្រគឺ URL អ៊ិនកូដឌី។
ការអ៊ិនកូដតួអក្សរ៖
អ្នកផ្តល់សេវាអាចជ្រើសរើសការអ៊ិនកូដតួអក្សរដែលពេញចិត្តដើម្បីប្រើ៖
UTF-8 (បានណែនាំ)
ISO-8859-1 ។
9.1 ការទទួលស្គាល់អ្នកផ្តល់សេវា
អ្នកផ្តល់សេវាគួរតែទទួលស្គាល់របាយការណ៍ចែកចាយនីមួយៗ។ ការទទួលស្គាល់អាចជាវិជ្ជមាន ពោលគឺរបាយការណ៍បញ្ជូនទទួលបានជោគជ័យ ឬអវិជ្ជមាន ពោលគឺបរាជ័យ។
សូមចំណាំ៖ LINK Mobility មានរយៈពេលអានសម្រាប់ការទទួលស្គាល់ 30 វិនាទីសម្រាប់របាយការណ៍ចែកចាយ។ ការអស់ពេលនឹងបង្កឱ្យមានការព្យាយាមចែកចាយឡើងវិញ (ប្រសិនបើការព្យាយាមម្តងទៀតត្រូវបានបើក) ឬការលុបចោលការដឹកជញ្ជូន (ប្រសិនបើការព្យាយាមម្តងទៀតត្រូវបានបិទ)។ នេះមានន័យថាកម្មវិធីអ្នកផ្តល់សេវាត្រូវតែធានានូវពេលវេលាឆ្លើយតបរហ័ស ជាពិសេសក្នុងអំឡុងពេលផ្ទុកខ្ពស់។
វាត្រូវបានផ្ដល់អនុសាសន៍យ៉ាងខ្លាំងឱ្យទទួលស្គាល់របាយការណ៍ចែកចាយទៅកាន់ LINK Mobility មុនពេលដំណើរការវា។
ច្បាប់សម្រាប់ការទទួលស្គាល់ជាវិជ្ជមាន និងអវិជ្ជមាន ត្រូវបានពិពណ៌នាដូចខាងក្រោម៖
ការទទួលស្គាល់ជាវិជ្ជមាន, ACK, របាយការណ៍នៃការចែកចាយត្រូវបានផ្តល់ជូន:
កូដឆ្លើយតបជួរ HTTP 200 រួមផ្សំជាមួយមាតិកាដែលបានធ្វើទ្រង់ទ្រាយ XML ខាងក្រោម៖
ការទទួលស្គាល់អវិជ្ជមាន, NAK, របាយការណ៍ដឹកជញ្ជូនមិនត្រូវបានចែកចាយទេ៖
ការឆ្លើយតបណាមួយក្រៅពីការទទួលស្គាល់ជាវិជ្ជមាន ឧampដូច្នេះ ការទទួលស្គាល់អវិជ្ជមានត្រូវបានបង្កឡើងដោយកូដកំហុស HTTP ណាមួយ ឬមាតិកា XML ខាងក្រោម៖
មាតិកា XML អាចត្រូវបានប្រើសម្រាប់ការគ្រប់គ្រងយន្តការព្យាយាមឡើងវិញនៃ LINK Mobility ។ NAK នឹងបង្កឱ្យមានការព្យាយាមម្តងទៀត ប្រសិនបើបានបើកដំណើរការ។ សម្រាប់អ្នកផ្តល់សេវាដែលមិនបានកំណត់រចនាសម្ព័ន្ធសម្រាប់យន្តការព្យាយាមម្តងទៀត មាតិកា XML គឺស្រេចចិត្ត។
ខាងក្រោមនេះគឺជាសំណើ HTTP POST និងការឆ្លើយតបឧample នៃរបាយការណ៍ដឹកជញ្ជូនដែលបានបញ្ជូនទៅអ្នកផ្តល់សេវា៖
សំណើ HTTP៖
POST /context/app HTTP/1.1
ប្រភេទមាតិកា៖ ពាក្យសុំ / x-www-form-urlបានអ៊ិនកូដ; សំណុំតួអក្សរ = utf-8
ម៉ាស៊ីន៖ ម៉ាស៊ីនមេ៖ ច្រក
ប្រវែងមាតិកា៖ xx
MessageId=213123213&DestinationAddress=46762050312&ប្រតិបត្តិករ=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 អត្រាស្តង់ដារ។
អ្នកផ្តល់សេវាដែលមានការព្យាយាមម្តងទៀតត្រូវតែពិនិត្យមើលលេខសម្គាល់តែមួយគត់នៃសារ MT ដើម្បីធានាថាសារមិនទាន់បានទទួល។
វាមានសារៈសំខាន់សម្រាប់អ្នកផ្តល់សេវាក្នុងការអនុលោមតាមច្បាប់សាមញ្ញទាំងនេះ នៅពេលដែលមានកំហុសកើតឡើងកំឡុងពេលដំណើរការរបាយការណ៍ចែកចាយ ប្រសិនបើហេតុផលសម្រាប់កំហុសគឺ៖ បណ្តោះអាសន្ន ឧ. មូលដ្ឋានទិន្នន័យមិនអាចប្រើបាន NAK គួរតែត្រូវបានបញ្ជូនមកវិញ។ LINK Mobility នឹងផ្ញើសារឡើងវិញ។
ការព្យាយាមជាអចិន្ត្រៃយ៍ និងការព្យាយាមម្តងទៀតទំនងជាបណ្តាលឱ្យមានបញ្ហាដូចគ្នា ACK គួរតែត្រូវបានត្រឡប់មកវិញ។ សម្រាប់អតីតample នៅពេលដែលសារមិនអាចញែកបានត្រឹមត្រូវ ឬបណ្តាលឱ្យមានកំហុសពេលដំណើរការដែលមិនបានរំពឹងទុក។
ការធ្វើសកម្មភាពតាមនោះនឹងធានាថាគ្មានការទប់ស្កាត់ ឬការថយចុះនៃលំហូរចេញត្រូវបានបង្កឡើងដោយសារតែរបាយការណ៍ចែកចាយត្រូវបានបញ្ជូនឡើងវិញម្តងហើយម្តងទៀត។
10. គន្លឹះនៃការអនុវត្ត
1. វាអាចទៅរួចក្នុងការប្រើប្រាស់របស់អ្នក។ web កម្មវិធីរុករកដើម្បីបញ្ជូនសំណើទៅ API ។ វាធ្វើឱ្យមានភាពងាយស្រួលក្នុងការរុករក និងវាយតម្លៃសេវាកម្មដោយគ្មានឧបករណ៍អភិវឌ្ឍន៍ណាមួយឡើយ។
2. Chrome ឬ Firefox ត្រូវបានណែនាំរួមគ្នាជាមួយផ្នែកបន្ថែមដូចជា JSONView ដើម្បីបង្ហាញ JSON ដែលមានទម្រង់ស្អាត។
3. យើងបានប្រើ SoapUI សម្រាប់សាកល្បង POST, Basic Authentication និងសម្រាប់ត្រួតពិនិត្យសំណើ HTTP ឆៅ និងសារឆ្លើយតប។
4. គURL ឧបករណ៍មានប្រយោជន៍សម្រាប់ការបញ្ជូនសំណើ POST ជាមួយនឹងការផ្ទៀងផ្ទាត់មូលដ្ឋាន។ សូមមើលអតីតampខាងក្រោម។
curl ប្រកាស \
-H “ប្រភេទមាតិកា៖ application/x-www-form-urlបានអ៊ិនកូដ” \
-H “ការអនុញ្ញាត៖ មូលដ្ឋាន am9objpjaGFuZ2VtZSA=” \\
https://europe.ipx.com/restapi/v1/sms/send \
–data “destinationAddress=46123456789&messageText=Hello+World%21”
_______________
ការផ្លាស់ប្តូរទំនាក់ទំនងផ្ទាល់ខ្លួន
ឯកសារ/ធនធាន
 |
ការណែនាំអំពីការអនុវត្តការចល័ត LINK REST API SMS [pdf] ការណែនាំអ្នកប្រើប្រាស់ ការណែនាំអំពីការអនុវត្តការចល័ត REST API SMS, ការចល័ត, ការណែនាំអំពីការអនុវត្ត REST API SMS, REST API SMS, API SMS, SMS |
