ലിങ്ക് മൊബിലിറ്റി ഇംപ്ലിമെൻ്റേഷൻ ഗൈഡ് REST API SMS
LINK മൊബിലിറ്റി സന്ദേശം ഡെലിവറി, മൈക്രോ പേയ്മെൻ്റുകൾ, ലൊക്കേഷൻ അടിസ്ഥാനമാക്കിയുള്ള സേവനങ്ങൾ എന്നിവയ്ക്കായി ഒരു സേവനം നൽകുന്നു. സേവന ദാതാക്കളും ഓപ്പറേറ്റർമാരും തമ്മിലുള്ള സുതാര്യമായ, വൈറ്റ്-ലേബൽ ഉള്ളടക്കം ഏറ്റെടുക്കുന്നയാളായും ഇടപാട് റൂട്ടറായും പ്ലാറ്റ്ഫോം പ്രവർത്തിക്കുന്നു.
LINK മൊബിലിറ്റി ഒരു RESTful API നൽകുന്നു, അത് SMS അയയ്ക്കുന്നത് പോലുള്ള LINK മൊബിലിറ്റി സേവനങ്ങൾ ആക്സസ് ചെയ്യാൻ ഉപയോഗിക്കാം. ഈ API രൂപകൽപ്പന ചെയ്തിരിക്കുന്നത് ഉപയോഗിക്കാൻ എളുപ്പമുള്ളതും എല്ലാ ആധുനിക ഭാഷകളുമായും ചട്ടക്കൂടുകളുമായും പൊരുത്തപ്പെടുന്നതുമാണ്. നിങ്ങൾക്ക് ഇഷ്ടമുള്ള ഭാഷ ഉപയോഗിച്ച്, ശക്തമായ സന്ദേശമയയ്ക്കലും പേയ്മെൻ്റ് കഴിവുകളും നടപ്പിലാക്കാൻ നിങ്ങളുടെ അപ്ലിക്കേഷന് Link Mobility REST API ഉപയോഗിക്കാം.
© LINK മൊബിലിറ്റി, മാർച്ച് 10, 2021
നിയമപരമായ വിവരങ്ങൾ
ഈ ഡോക്യുമെൻ്റിൽ നൽകിയിരിക്കുന്ന വിവരങ്ങൾ Netsize-ൻ്റെ ഏക സ്വത്തും പകർപ്പവകാശവുമാണ്. ഇത് രഹസ്യാത്മകവും കർശനമായ വിവര ഉപയോഗത്തിന് ഉദ്ദേശിച്ചുള്ളതുമാണ്. ഇത് ബൈൻഡിംഗ് അല്ല, അറിയിപ്പ് കൂടാതെ മാറ്റങ്ങൾക്ക് വിധേയമായേക്കാം. ഏതെങ്കിലും അനധികൃത വെളിപ്പെടുത്തൽ അല്ലെങ്കിൽ ഉപയോഗം നിയമവിരുദ്ധമായി കണക്കാക്കും.
Netsize™, linkmobility™ എന്നിവ ഫ്രഞ്ച്, EEC, അന്തർദേശീയ ബൗദ്ധിക സ്വത്തവകാശ നിയമങ്ങളാൽ സംരക്ഷിക്കപ്പെട്ടിരിക്കുന്നു.
ഉദ്ധരിച്ച മറ്റെല്ലാ വ്യാപാരമുദ്രകളും അവയുടെ ഉടമസ്ഥരുടെ മാത്രം സ്വത്താണ്.
Netsize പേറ്റൻ്റ്, പകർപ്പവകാശം അല്ലെങ്കിൽ വ്യാപാരമുദ്ര എന്നിവയ്ക്ക് കീഴിൽ ഏതെങ്കിലും ലൈസൻസോ അവകാശമോ നൽകുന്നതായി ഇവിടെ അടങ്ങിയിരിക്കുന്ന യാതൊന്നും കണക്കാക്കില്ല.
നെറ്റ്സൈസ്
Société അനോണിം അല്ലെങ്കിൽ മൂലധനം 5 478 070 യൂറോ
Siège social :62, അവന്യൂ എമിൽ സോള92100 ബൊലോൺ - ഫ്രാൻസ്
418 712 477 ആർസിഎസ് നന്തെരെ
http://www.LinkMobility.com
http://www.linkmobility.com
പ്രമാണത്തിന്റെ വ്യാപ്തി
സേവന ദാതാവ് എങ്ങനെയാണ് SMS-നായി LINK മൊബിലിറ്റി REST API ഉപയോഗിക്കുന്നത് എന്ന് ഈ പ്രമാണം വിവരിക്കുന്നു. സേവന ദാതാവിൻ്റെ സേവനങ്ങൾ നടപ്പിലാക്കുന്ന സാങ്കേതിക ആർക്കിടെക്റ്റുകൾക്കും ഡിസൈനർമാർക്കും വേണ്ടിയുള്ളതാണ് ഇത്.
1. അടിസ്ഥാന ഉപയോഗം
എസ്എംഎസ് അയയ്ക്കുന്നത് വളരെ എളുപ്പമാണ്. LINK മൊബിലിറ്റിയിലേക്ക് നിങ്ങൾ ഒരു HTTP അഭ്യർത്ഥന അയയ്ക്കുന്നു, അത് ഒരു ഉപയോഗിച്ച് പൂർത്തിയാക്കാൻ കഴിയും web ബ്രൗസർ.
2. ഫങ്ഷണൽ ഓവർview
LINK മൊബിലിറ്റി സിസ്റ്റം SMS സന്ദേശങ്ങൾക്കായി ഇനിപ്പറയുന്ന അടിസ്ഥാന പ്രവർത്തനം നൽകുന്നു:
ടെക്സ്റ്റ് അല്ലെങ്കിൽ ബൈനറി (ഉദാ. WAP പുഷ്) പ്രീമിയം, സ്റ്റാൻഡേർഡ് റേറ്റ് സന്ദേശങ്ങൾ പോലെയുള്ള മൊബൈൽ ടെർമിനേറ്റഡ് (MT) SMS സന്ദേശങ്ങൾ അയയ്ക്കുന്നു.
സമർപ്പിച്ച MT സന്ദേശങ്ങൾക്കുള്ള ഡെലിവറി റിപ്പോർട്ടുകൾ സ്വീകരിക്കുന്നു.
മൊബൈൽ ഒറിജിനേറ്റഡ് (MO) SMS സന്ദേശങ്ങൾ, പ്രീമിയം, സ്റ്റാൻഡേർഡ് നിരക്ക് എന്നിവ സ്വീകരിക്കുന്നു.
സാധാരണ നിരക്ക് MT SMS സന്ദേശങ്ങൾ അയയ്ക്കുന്നതിന് SMS REST API സമർപ്പിതമാണ്.
API എല്ലാ SMS സന്ദേശങ്ങളും അസമന്വിതമായി അയയ്ക്കുന്നു, ഇതുപോലുള്ള സവിശേഷതകൾ പ്രവർത്തനക്ഷമമാക്കുന്നു:
"ഫയർ-ആൻഡ്-മറക്കുക" - സേവന ദാതാവ് കൂടുതൽ പ്രവചനാതീതമായ പ്രതികരണ സമയം ലഭിക്കാൻ ആഗ്രഹിക്കുന്നു, കൂടാതെ ഓപ്പറേറ്ററിൽ നിന്നുള്ള ഫലത്തിനായി കാത്തിരിക്കാൻ ആഗ്രഹിക്കുന്നില്ല.
പ്രവർത്തനക്ഷമത വീണ്ടും ശ്രമിക്കുക - ഓപ്പറേറ്റർക്ക് താൽക്കാലിക പ്രശ്നങ്ങളുണ്ടെങ്കിൽ LINK മൊബിലിറ്റി സന്ദേശം വീണ്ടും അയയ്ക്കും.
2.1 ഒരു SMS സന്ദേശം അയയ്ക്കുന്നു
സേവന ദാതാവ് നെറ്റ്സൈസ് ഉപഭോക്താവ്
- MT സന്ദേശം അയയ്ക്കുക
- റിട്ടേൺ മെസേജ് ഐഡി
- SMS സന്ദേശം സമർപ്പിക്കുക
- ഡെലിവറി റിപ്പോർട്ട് നൽകുക
- ഡെലിവറി റിപ്പോർട്ട് അയയ്ക്കുക
ഒരു SMS സന്ദേശങ്ങൾ അയക്കുന്നതിനുള്ള അടിസ്ഥാന ഫ്ലോ ഇനിപ്പറയുന്ന രീതിയിൽ വിവരിച്ചിരിക്കുന്നു:
LINK മൊബിലിറ്റി സിസ്റ്റം വഴി ഒരു സ്വീകർത്താവിന് ഒരു SMS സന്ദേശം അയയ്ക്കാൻ സേവന ദാതാവ് ഒരു അഭ്യർത്ഥന നടത്തുന്നു.
ഒരു സന്ദേശ ഐഡി സേവന ദാതാവിന് തിരികെ നൽകും. ശരിയായ ഡെലിവറി റിപ്പോർട്ടുമായി സന്ദേശത്തെ പരസ്പരബന്ധിതമാക്കുന്നതിന് ഈ ഐഡി ഉപയോഗിക്കാം.
ലിങ്ക് മൊബിലിറ്റി റൂട്ടിംഗ് കൈകാര്യം ചെയ്യുകയും വിലാസമുള്ള ഉപഭോക്താവിന് SMS സന്ദേശം നൽകുകയും ചെയ്യുന്നു.
ഒരു ഡെലിവറി റിപ്പോർട്ട് ട്രിഗർ ചെയ്യപ്പെടുന്നു, ഉദാ. ഉപഭോക്താവിൻ്റെ ഉപകരണത്തിലേക്ക് SMS സന്ദേശം ഡെലിവർ ചെയ്യുമ്പോൾ.
ഡെലിവറി റിപ്പോർട്ട് സേവന ദാതാവിന് അയച്ചു. ഘട്ടം 2-ൽ നൽകിയ അതേ സന്ദേശ ഐഡി റിപ്പോർട്ടിൽ അടങ്ങിയിരിക്കുന്നു.
ഇതര ഫ്ലോ: അസാധുവായ അഭ്യർത്ഥന
അഭ്യർത്ഥനയിൽ നൽകിയിരിക്കുന്ന പാരാമീറ്ററുകളോ ഉപയോക്തൃ ക്രെഡൻഷ്യലുകളോ അസാധുവാണെങ്കിൽ, ഒരു പിശക് സേവന ദാതാവിന് തിരികെ നൽകും. പിശക് നിരസിക്കാനുള്ള കാരണം സൂചിപ്പിക്കുന്നു, ഒഴുക്ക് അവസാനിക്കുന്നു. സന്ദേശ ഐഡികളൊന്നും തിരികെ നൽകുന്നില്ല.
3. എൻഡ് പോയിൻ്റ്
SMS റിസോഴ്സ് പാത്ത് ഉപയോഗിച്ച് ആക്സസ് ചെയ്യപ്പെടുന്നു:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
കണക്ഷൻ സുരക്ഷയ്ക്കായി, LINK മൊബിലിറ്റി REST API HTTPS വഴി മാത്രമേ ആക്സസ് ചെയ്യാനാകൂ.
ലിങ്ക് മൊബിലിറ്റി സെർവർ സർട്ടിഫിക്കറ്റിൽ Thawte Server CA ഒപ്പിട്ടിരിക്കുന്നു.
4. പ്രവർത്തനങ്ങൾ
SMS സേവനം ഇനിപ്പറയുന്ന പ്രവർത്തനങ്ങൾ നൽകുന്നു:
| പേര് | പാത |
| അയക്കുക | /restapi/v1/sms/send |
4.1 അയയ്ക്കുക
ഒരൊറ്റ സ്വീകർത്താവിന് SMS അയയ്ക്കാൻ അയയ്ക്കൽ പ്രവർത്തനം ഉപയോഗിക്കുന്നു.
ഈ പ്രവർത്തനം അടിസ്ഥാനപരവും നൂതനവുമായ ഉപയോക്താക്കൾക്കായി ഉദ്ദേശിച്ചുള്ളതാണ്. ഏറ്റവും ലളിതമായ സാഹചര്യത്തിൽ, ഒരു SMS ഡെലിവർ ചെയ്യുന്നതിന് ലക്ഷ്യസ്ഥാന വിലാസവും സന്ദേശ വാചകവും മാത്രമേ ആവശ്യമുള്ളൂ. LINK മൊബിലിറ്റി ഡാറ്റാ കോഡിംഗ് സ്കീം കണ്ടെത്തുകയും ആവശ്യമെങ്കിൽ ഒരു സന്ദേശത്തെ ഒന്നിലധികം സന്ദേശ ഭാഗങ്ങളായി സ്വയമേവ സംയോജിപ്പിക്കുകയും ചെയ്യും.
വിപുലമായ ഉപയോഗത്തിന്, ഉപയോക്തൃ ഡാറ്റാ തലക്കെട്ട് ഉൾപ്പെടെ സന്ദേശ ഫോർമാറ്റിംഗിൻ്റെ പൂർണ്ണ നിയന്ത്രണത്തിനായി സേവന ദാതാവിന് ഓപ്ഷണൽ പാരാമീറ്ററുകൾ ഉപയോഗിക്കാം.
സേവന ദാതാവിന് സംയോജിത സന്ദേശങ്ങൾ അയയ്ക്കാൻ കഴിയും, എന്നാൽ ഉപയോക്തൃ ഡാറ്റയും ഉപയോക്തൃ ഡാറ്റാ തലക്കെട്ടും തയ്യാറാക്കുന്നത് സേവന ദാതാവ് നടത്തുകയും ലിങ്ക് മൊബിലിറ്റിയിലേക്ക് ഒന്നിലധികം അയയ്ക്കൽ അഭ്യർത്ഥനകൾ മുഖേന സന്ദേശം അയയ്ക്കുകയും വേണം.
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
ഉദാampലെ, ഹലോ വേൾഡ്! Hello+World%21 ആയി എൻകോഡ് ചെയ്തിരിക്കുന്നു.
6.2 നിർബന്ധിത അഭ്യർത്ഥന പാരാമീറ്ററുകൾ
| പേര് | പരമാവധി നീളം | വിവരണം |
| ലക്ഷ്യ വിലാസം | 40 | രാജ്യ കോഡിൽ തുടങ്ങി SMS സന്ദേശം അയയ്ക്കേണ്ട MSISDN. ഉദാampലെ: 46123456789. ചില മാർക്കറ്റുകൾക്ക് (ഉപഭോക്താവ് MSISDN അവ്യക്തമാക്കേണ്ടയിടത്ത്) ഈ മൂല്യം "#" എന്ന പ്രിഫിക്സ് ഉള്ള ഒരു ആൽഫാന്യൂമെറിക് അപരനാമവും ആകാം. |
| സന്ദേശം വാചകം | 1600 | SMS സന്ദേശത്തിൻ്റെ ഉള്ളടക്കം. |
6.3 ഓപ്ഷണൽ അഭ്യർത്ഥന പാരാമീറ്ററുകൾ (വിപുലമായ ഉപയോഗത്തിന്)
| പേര് | പരമാവധി നീളം | വിവരണം |
| ഉത്ഭവ വിലാസം | 16 | ഔട്ട്ഗോയിംഗ് SMS സന്ദേശത്തിൻ്റെ ഉത്ഭവ വിലാസം. ഒറിജിനേറ്റിംഗ് വിലാസത്തിൻ്റെ തരം നിർവചിക്കുന്നത് ഒറിജിനേറ്റർടൺ പാരാമീറ്റർ ആണ്. ഹ്രസ്വ സംഖ്യ പരമാവധി ദൈർഘ്യം 16 ആണ്. പരമാവധി ദൈർഘ്യം 11 പ്രതീകങ്ങളുള്ള GSM ഡിഫോൾട്ട് ആൽഫബെറ്റിൽ ആൽഫ ന്യൂമെറിക് അയച്ചയാളെ പരിമിതപ്പെടുത്തിയിരിക്കുന്നു. MSISDN അയയ്ക്കുന്നയാളുടെ പരമാവധി ദൈർഘ്യം 15 ആണ് (destinationAddress എലമെൻ്റിൻ്റെ അതേ ഫോർമാറ്റ് ഉപയോഗിച്ച്). ഒറിജിനേറ്റിംഗ് വിലാസവും ഒറിജിനേറ്റിംഗ് ടണും സിസ്റ്റം തിരഞ്ഞെടുക്കുമ്പോൾ ഒഴിവാക്കാവുന്നതാണ്. ഈ പ്രവർത്തനം മാർക്കറ്റിനെയും കോൺഫിഗറേഷനെയും ആശ്രയിച്ചിരിക്കുന്നു. ഓപ്പറേറ്റർ സംയോജനങ്ങൾ അനുസരിച്ച് പെരുമാറ്റം വ്യത്യാസപ്പെടാം. |
| ഉത്ഭവം ടോൺ | 1 | ഉത്ഭവിക്കുന്ന വിലാസത്തിൻ്റെ സംഖ്യയുടെ തരം (TON): 0 - ഹ്രസ്വ സംഖ്യ 1 - ആൽഫ ന്യൂമെറിക് (പരമാവധി നീളം 11) 2 - MSISDN വിലാസം ഉത്ഭവിക്കുമ്പോൾ ഒഴിവാക്കാവുന്നതാണ്, കൂടാതെ ഒറിജിനേറ്റിംഗ്TON സിസ്റ്റം തിരഞ്ഞെടുക്കും. ഈ ഫംഗ്ഷൻ മാർക്കറ്റിനെയും കോൺഫിഗറേഷനെയും ആശ്രയിച്ചിരിക്കുന്നു. ഓപ്പറേറ്റർ സംയോജനങ്ങൾ അനുസരിച്ച് പെരുമാറ്റം വ്യത്യാസപ്പെടാം. |
| userDataHeader | 280 | ഉപയോക്തൃ ഡാറ്റാ തലക്കെട്ടിൽ ഉപയോക്തൃ ഡാറ്റയ്ക്കൊപ്പം 140 വരെ അടങ്ങിയിരിക്കാം, അതായത് ഹെക്സ്-എൻകോഡ് ചെയ്യുമ്പോൾ 280, ഒക്ടെറ്റുകൾ. ഈ പരാമീറ്റർ എപ്പോഴും ഹെക്സ്-എൻകോഡ് ചെയ്തിരിക്കുന്നു. |
| ഡി.സി.എസ് | 3 | ഡാറ്റ കോഡിംഗ് സ്കീം. ഓപ്പറേറ്റർ സംയോജനങ്ങൾ അനുസരിച്ച് പെരുമാറ്റം വ്യത്യാസപ്പെടാം. |
| PID | 3 | പ്രോട്ടോക്കോൾ ഐഡി. ഓപ്പറേറ്റർ സംയോജനങ്ങൾ അനുസരിച്ച് പെരുമാറ്റം വ്യത്യാസപ്പെടാം. |
| ആപേക്ഷിക സാധുത സമയം | 6 | ആപേക്ഷിക സാധുത നിമിഷങ്ങൾക്കുള്ളിൽ (LINK മൊബിലിറ്റിക്ക് സമർപ്പിക്കുന്നതിനുള്ള സമയവുമായി ബന്ധപ്പെട്ട്). പരമാവധി മൂല്യം 604800 (7 ദിവസം), ഡിഫോൾട്ട് 48 മണിക്കൂർ. ഓപ്പറേറ്റർ സംയോജനങ്ങൾ അനുസരിച്ച് പെരുമാറ്റം വ്യത്യാസപ്പെടാം. |
| ഡെലിവറി സമയം | 20 | ടൈംസ്റ്റ്amp SMS സന്ദേശം ഡെലിവറി ചെയ്യേണ്ട സമയത്ത് (ഡെലിവറി സമയം വൈകി). തീയതി സമയ ഫോർമാറ്റിലെ വിഭാഗം കാണുക. |
| സ്റ്റാറ്റസ് റിപ്പോർട്ട് ഫ്ലാഗുകൾ | 1 | റിപ്പോർട്ട് അഭ്യർത്ഥന കൈമാറുക: 0 - ഡെലിവറി റിപ്പോർട്ട് ഇല്ല (സ്ഥിരസ്ഥിതി) 1 - ഡെലിവറി റിപ്പോർട്ട് അഭ്യർത്ഥിച്ചു 9 – സെർവർ ഡെലിവറി റിപ്പോർട്ട് അഭ്യർത്ഥിച്ചു (ലിങ്ക് മൊബിലിറ്റി റിപ്പോർട്ട് സേവന ദാതാവിന് കൈമാറുന്നില്ല, എന്നാൽ റിപ്പോർട്ടുകളിൽ ഇത് ലഭ്യമാക്കുന്നു.) |
| campaignname | 50 | LINK മൊബിലിറ്റി ഇടപാടുകൾ tagഈ പേരിൽ ged. ലിങ്ക് മൊബിലിറ്റി റിപ്പോർട്ടുകളിൽ ഗ്രൂപ്പ് ഇടപാടുകൾക്കായി ഇത് ഉപയോഗിക്കുന്നു. |
| maxConcatenated Messages | 1 | 1-നും 10-നും ഇടയിലുള്ള മൂല്യം, എത്ര സംയോജിത സന്ദേശങ്ങൾ അനുവദനീയമാണെന്ന് നിർവചിക്കുന്നു. സ്ഥിരസ്ഥിതി 3 ആണ്. |
| പരസ്പരബന്ധം ഐഡി | 100 | സേവന ദാതാവ് നൽകുന്ന ഐഡി അത് ഡെലിവറി റിപ്പോർട്ടിൽ പ്രതിധ്വനിക്കും. |
| ഉപയോക്തൃനാമം | 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=Hello+World%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=
ഉള്ളടക്ക ദൈർഘ്യം: 57
destinationAddress=46123456789&messageText=Hello+World%21
6.5 തീയതിയും സമയവും
തീയതിയും സമയവും പ്രതിനിധീകരിക്കുന്ന REST API ലെ പാരാമീറ്ററുകൾ എല്ലായ്പ്പോഴും UTC സമയ മേഖലയിലാണ് (കോഓർഡിനേറ്റഡ് യൂണിവേഴ്സൽ സമയം). സമയക്രമംampഈ കൃത്യമായ ഫോർമാറ്റിലുള്ള ഒരു സ്ട്രിംഗ് ആയി s പ്രതിനിധീകരിക്കുന്നു:
2017-04-25T23:20:50Z
ഇത് 20 ഏപ്രിൽ 50-ൻ്റെ 23-ാം മണിക്കൂറിന് ശേഷമുള്ള 25 മിനിറ്റും 2017 സെക്കൻഡും യുടിസിയിൽ പ്രതിനിധീകരിക്കുന്നു.
7. പ്രതികരണ സന്ദേശം
ഒരു അഭ്യർത്ഥന സന്ദേശം സ്വീകരിച്ച് വ്യാഖ്യാനിച്ചതിന് ശേഷം API ഒരു HTTP പ്രതികരണ സന്ദേശം ഉപയോഗിച്ച് പ്രതികരിക്കുന്നു.
7.1 HTTP സ്റ്റാറ്റസ് കോഡ്
പ്രോസസ്സ് ചെയ്ത അഭ്യർത്ഥനകൾക്കായി REST API എല്ലായ്പ്പോഴും HTTP സ്റ്റാറ്റസ് കോഡ് 200 ശരി നൽകുന്നു. കൃത്യമായ ഫലം നിർണ്ണയിക്കാൻ ഉപയോഗിക്കുന്ന ഒരു പാരാമീറ്റർ പ്രതികരണ കോഡ് സന്ദേശ ബോഡിയിൽ അടങ്ങിയിരിക്കുന്നു.
7.2 സന്ദേശ ബോഡി
സന്ദേശ ബോഡിയിൽ അഭ്യർത്ഥനയുടെ ഫലം വിവരിക്കുന്ന JSON അടങ്ങിയിരിക്കുന്നു.
http://json.org/
ലിങ്ക് മൊബിലിറ്റി JSON Google JSON സ്റ്റൈൽ ഗൈഡിന് അനുസൃതമാണ്.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 പ്രതികരണ പാരാമീറ്ററുകൾ
| പേര് | പരമാവധി നീളം | വിവരണം |
| പ്രതികരണ കോഡ് | 3 | 0 വിജയകരമായ ഇടപാടിനെ സൂചിപ്പിക്കുന്നു. |
| പ്രതികരണ സന്ദേശം | 255 | പ്രതികരണ വാചക വിവരണം, ഉദാ: പിശക് വാചകം. |
| ടൈംസ്റ്റ്amp | 20 | LINK മൊബിലിറ്റി അഭ്യർത്ഥന പ്രോസസ്സ് ചെയ്ത തീയതിയും സമയവും. (തീയതി/സമയ ഫോർമാറ്റ് വിഭാഗം കാണുക). |
| ട്രേസ് ഐഡി | 36 | ലിങ്ക് മൊബിലിറ്റി ആന്തരിക ഐഡൻ്റിഫയർ. പിന്തുണയ്ക്കും പ്രശ്നപരിഹാരത്തിനും ഉപയോഗിക്കുന്നു. |
| സന്ദേശ ഐഡികൾ | 10 x 36 | ഓരോ വിജയകരമായ സന്ദേശത്തിനും ലിങ്ക് മൊബിലിറ്റി അദ്വിതീയ സന്ദേശ ഐഡികളുടെ നിര (സന്ദേശം സംയോജിപ്പിച്ചിട്ടുണ്ടെങ്കിൽ ഒന്നിലധികം സന്ദേശ ഐഡികൾ തിരികെ നൽകും). പരാജയപ്പെട്ടാൽ ഒഴിവാക്കി. |
7.4 ഉദാampലെ പ്രതികരണങ്ങൾ
വിജയം
HTTP/1.1 200 ശരി
ഉള്ളടക്ക തരം: ആപ്ലിക്കേഷൻ/json
ഉള്ളടക്ക ദൈർഘ്യം: 144
തീയതി: വ്യാഴം, 15 സെപ്റ്റംബർ 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”വിജയം”,”സമയം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 ശരി
ഉള്ളടക്ക തരം: ആപ്ലിക്കേഷൻ/json
ഉള്ളടക്ക ദൈർഘ്യം: 148
തീയതി: വ്യാഴം, 15 സെപ്റ്റംബർ 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” അസാധുവായ ലോഗിൻ അല്ലെങ്കിൽ അംഗീകൃതമല്ലാത്ത API ഉപയോഗം”,സമയംamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
വിജയം
HTTP/1.1 200 ശരി
ഉള്ളടക്ക തരം: ആപ്ലിക്കേഷൻ/json
ഉള്ളടക്ക ദൈർഘ്യം: 144
തീയതി: വ്യാഴം, 15 സെപ്റ്റംബർ 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”വിജയം”,”സമയം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 ശരി
ഉള്ളടക്ക തരം: ആപ്ലിക്കേഷൻ/json
ഉള്ളടക്ക ദൈർഘ്യം: 148
തീയതി: വ്യാഴം, 15 സെപ്റ്റംബർ 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” അസാധുവായ ലോഗിൻ അല്ലെങ്കിൽ അംഗീകൃതമല്ലാത്ത API ഉപയോഗം”,സമയംamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 പ്രതികരണ കോഡുകൾ
അയയ്ക്കുന്ന പ്രതികരണത്തിൽ ഇനിപ്പറയുന്ന പ്രതികരണ കോഡുകൾ നൽകാം:
| കോഡ് | വാചകം | വിവരണം |
| 0 | വിജയം | വിജയകരമായി നടപ്പിലാക്കി. |
| 1 | അസാധുവായ ലോഗിൻ അല്ലെങ്കിൽ അംഗീകൃതമല്ലാത്ത API ഉപയോഗം | തെറ്റായ ഉപയോക്തൃനാമം അല്ലെങ്കിൽ പാസ്വേഡ് അല്ലെങ്കിൽ സേവന ദാതാവിനെ LINK മൊബിലിറ്റി തടഞ്ഞിരിക്കുന്നു. |
| 2 | ലിങ്ക് മൊബിലിറ്റി ഉപഭോക്താവിനെ തടഞ്ഞു | LINK മൊബിലിറ്റി ഉപഭോക്താവിനെ തടഞ്ഞു. |
| 3 | LINK മൊബിലിറ്റി നൽകുന്നതല്ല പ്രവർത്തനം | സേവന ദാതാവിനായി പ്രവർത്തനം തടഞ്ഞിരിക്കുന്നു. |
| 4 | മൊബിലിറ്റിയെ ലിങ്ക് ചെയ്യാൻ ഉപഭോക്താവിന് അറിയില്ല | LINK മൊബിലിറ്റിക്ക് ഉപഭോക്താവിന് അറിയില്ല. അല്ലെങ്കിൽ അഭ്യർത്ഥനയിൽ അപരനാമം ഉപയോഗിച്ചിരുന്നെങ്കിൽ; അപരനാമം കണ്ടെത്തിയില്ല. |
| 5 | LINK മൊബിലിറ്റിയിൽ ഉപഭോക്താവ് ഈ സേവനം തടഞ്ഞു | LINK മൊബിലിറ്റിയിൽ ഉപഭോക്താവ് ഈ സേവനം തടഞ്ഞു. |
| 6 | ഉത്ഭവിക്കുന്ന വിലാസം പിന്തുണയ്ക്കുന്നില്ല | ഉത്ഭവിക്കുന്ന വിലാസം പിന്തുണയ്ക്കുന്നില്ല. |
| 7 | ആൽഫ ഉത്ഭവിക്കുന്ന വിലാസം അക്കൗണ്ട് പിന്തുണയ്ക്കുന്നില്ല | ആൽഫ ഉത്ഭവിക്കുന്ന വിലാസം അക്കൗണ്ട് പിന്തുണയ്ക്കുന്നില്ല. |
| 8 | MSISDN ഉത്ഭവ വിലാസം പിന്തുണയ്ക്കുന്നില്ല | MSISDN ഉത്ഭവ വിലാസം പിന്തുണയ്ക്കുന്നില്ല. |
| 9 | GSM വിപുലീകൃത പിന്തുണയില്ല | GSM വിപുലീകൃത പിന്തുണയില്ല. |
| 10 | യൂണികോഡ് പിന്തുണയ്ക്കുന്നില്ല | യൂണികോഡ് പിന്തുണയ്ക്കുന്നില്ല. |
| 11 | സ്റ്റാറ്റസ് റിപ്പോർട്ട് പിന്തുണയ്ക്കുന്നില്ല | സ്റ്റാറ്റസ് റിപ്പോർട്ട് പിന്തുണയ്ക്കുന്നില്ല. |
| 12 | ആവശ്യമായ കഴിവ് പിന്തുണയ്ക്കുന്നില്ല | സന്ദേശം അയയ്ക്കുന്നതിന് ആവശ്യമായ കഴിവ് (മുകളിൽ പറഞ്ഞവ ഒഴികെ) പിന്തുണയ്ക്കുന്നില്ല. |
| 13 | ഉള്ളടക്ക ദാതാവിൻ്റെ പരമാവധി ത്രോട്ടിലിംഗ് നിരക്ക് കവിഞ്ഞു | സേവന ദാതാവ് വളരെ വേഗത്തിൽ LINK മൊബിലിറ്റിയിലേക്ക് SMS സന്ദേശങ്ങൾ അയയ്ക്കുന്നു. |
| 14 | പ്രോട്ടോക്കോൾ ഐഡി അക്കൗണ്ട് പിന്തുണയ്ക്കുന്നില്ല | പ്രോട്ടോക്കോൾ ഐഡി പിന്തുണയ്ക്കുന്നില്ല. |
| 15 | സന്ദേശ സംയോജന പരിധി കവിഞ്ഞു | സംയോജിപ്പിച്ച സന്ദേശങ്ങളുടെ എണ്ണം അഭ്യർത്ഥിച്ച പരമാവധി എണ്ണത്തേക്കാൾ കൂടുതലാണ്. |
| 16 | സന്ദേശം റൂട്ട് ചെയ്യാനായില്ല. | LINK മൊബിലിറ്റിക്ക് സന്ദേശം റൂട്ട് ചെയ്യാൻ കഴിഞ്ഞില്ല. |
| 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എയിൻ പേര് | സിampaign പേര് അസാധുവാണ്. |
| 120 | സംയോജിപ്പിച്ച സന്ദേശങ്ങളുടെ പരമാവധി എണ്ണം അസാധുവാണ് | സംയോജിപ്പിച്ച സന്ദേശങ്ങളുടെ പരമാവധി എണ്ണം അസാധുവാണ്. |
| 121 | അസാധുവായ msisdn ഉത്ഭവ വിലാസം | MSISDN ഉത്ഭവിക്കുന്ന വിലാസം അസാധുവാണ്. |
| 122 | അസാധുവായ പരസ്പര ബന്ധ ഐഡി | പരസ്പര ബന്ധ ഐഡി അസാധുവാണ്. |
8. ഓപ്ഷണൽ സവിശേഷതകൾ
8.1 MSISDN തിരുത്തൽ
MSISDN തിരുത്തൽ എന്നത് ഒരു ഓപ്ഷണൽ സവിശേഷതയാണ്, അഭ്യർത്ഥിച്ചാൽ LINK മൊബിലിറ്റി പിന്തുണ ഉപയോഗിച്ച് പ്രവർത്തനക്ഷമമാക്കാനാകും.
ഈ ഫീച്ചർ ലക്ഷ്യസ്ഥാന വിലാസങ്ങൾ ശരിയാക്കുകയും ആവശ്യമായ E.164 ഫോർമാറ്റിലേക്ക് വിന്യസിക്കുകയും ചെയ്യും. ഫോർമാറ്റ് തിരുത്തലിനു പുറമേ, ബാധകമാകുമ്പോൾ DOM-TOM (départements et territorires d'outre-mer) നമ്പറുകൾ ശരിയാക്കാൻ അന്തർദ്ദേശീയ ഫ്രഞ്ച് നമ്പറുകൾ വിവർത്തനം ചെയ്യുന്നത് പോലുള്ള മാർക്കറ്റ് നിർദ്ദിഷ്ട പ്രവർത്തനങ്ങളും സിസ്റ്റം നിർവഹിക്കും.
ചില മുൻനിരകൾ ചുവടെയുണ്ട്ampതിരുത്തലുകളുടെ കുറവ്:
| സമർപ്പിച്ച ലക്ഷ്യ വിലാസം | ലക്ഷ്യസ്ഥാന വിലാസം ശരിയാക്കി |
| +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 നമ്പറിലേക്ക് വിവർത്തനം ചെയ്തു) |
കൂടാതെ, ഒരു തിരഞ്ഞെടുത്ത മാർക്കറ്റിനായി ദേശീയ ഫോൺ നമ്പറുകൾ അനുവദിക്കുന്നത് സാധ്യമാണ്. ഈ ഫീച്ചർ പ്രവർത്തനക്ഷമമാക്കുമ്പോൾ, മറ്റ് വിപണികൾക്കായുള്ള ഏതെങ്കിലും അന്താരാഷ്ട്ര നമ്പറുകൾ തിരഞ്ഞെടുത്ത മാർക്കറ്റിൽ നിന്ന് വേർതിരിച്ചറിയാൻ ഒരു പ്രാരംഭ `+' ചിഹ്നത്തോടൊപ്പം അയയ്ക്കണം.
താഴെ നിരവധി മുൻampദേശീയ നമ്പറുകൾക്കുള്ള ഡിഫോൾട്ട് മാർക്കറ്റായി സ്വീഡൻ (രാജ്യ കോഡ് 46) ഉപയോഗിക്കുമ്പോൾ തിരുത്തലുകൾ വരുത്തിയിട്ടുണ്ട്.
| സമർപ്പിച്ച ലക്ഷ്യ വിലാസം | ലക്ഷ്യസ്ഥാന വിലാസം ശരിയാക്കി |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | '+' ചിഹ്നം കാണാത്തതിനാൽ അസാധുവാണ് |
തിരുത്തിയ MSISDN LINK മൊബിലിറ്റി ഉപയോഗിക്കുമെന്നും അത് ഡെലിവറി റിപ്പോർട്ടുകളിൽ തിരികെ നൽകുമെന്നും ശ്രദ്ധിക്കുക.
കൂടുതൽ വിവരങ്ങൾക്ക് LINK മൊബിലിറ്റി പിന്തുണയുമായി ബന്ധപ്പെടുക.
8.2 പ്രതീകം മാറ്റിസ്ഥാപിക്കൽ
അഭ്യർത്ഥിച്ചാൽ LINK മൊബിലിറ്റി പിന്തുണ ഉപയോഗിച്ച് പ്രവർത്തനക്ഷമമാക്കാവുന്ന ഒരു ഓപ്ഷണൽ സവിശേഷതയാണ് പ്രതീകം മാറ്റിസ്ഥാപിക്കൽ.
DCS "GSM" (17) ആയി സജ്ജീകരിക്കുമ്പോൾ ഈ സവിശേഷത ഉപയോക്തൃ ഡാറ്റയിലെ (SMS ടെക്സ്റ്റ്) GSM ഇതര അക്ഷരമാല പ്രതീകങ്ങളെ തുല്യമായ GSM അക്ഷരമാല പ്രതീകങ്ങളിലേക്ക് വിവർത്തനം ചെയ്യും. ഉദാample "Seqüência de teste em Português" എന്നത് "Seqüencia de teste em Portugues" എന്ന് വിവർത്തനം ചെയ്യപ്പെടും.
9. ഡെലിവറി റിപ്പോർട്ടുകൾ
വ്യവസ്ഥ ചെയ്തിട്ടുണ്ടെങ്കിൽ, അയച്ച MT സന്ദേശങ്ങൾക്കായി SMS സന്ദേശ ഡെലിവറി റിപ്പോർട്ടുകളോ ഡെലിവറി അറിയിപ്പുകളോ അഭ്യർത്ഥിക്കാൻ സേവന ദാതാവിന് കഴിയും. MT സന്ദേശം ടാർഗെറ്റുചെയ്ത ഉപഭോക്താവിന് കൈമാറുമ്പോഴോ ഇല്ലാതാക്കപ്പെടുമ്പോഴോ, ഉദാഹരണത്തിന്, കാലഹരണപ്പെട്ടതോ, ചില കാരണങ്ങളാൽ, റൂട്ട് ചെയ്യാൻ കഴിയാത്തതോ ആയപ്പോൾ, ഓപ്പറേറ്റർ SMSC-യിൽ ഈ റിപ്പോർട്ടുകൾ പ്രവർത്തനക്ഷമമാകും.
SMS സന്ദേശത്തിൻ്റെ അന്തിമ നില മാത്രമേ സേവന ദാതാവിനെ അറിയിക്കുകയുള്ളൂ, അതായത്, ഡെലിവർ ചെയ്തതോ ഇല്ലാതാക്കിയതോ. ഒരു MT സന്ദേശത്തിന് ഒരു റിപ്പോർട്ട് മാത്രമേ സൃഷ്ടിക്കൂ. ഇല്ലാതാക്കിയ സ്റ്റാറ്റസിനൊപ്പം, ഒരു കാരണ കോഡ് ബാധകമായേക്കാം. ഈ കാരണം കോഡ് SMS സന്ദേശം കൈമാറാത്തതിൻ്റെ കാരണം വ്യക്തമാക്കുന്നു.
LINK മൊബിലിറ്റി വഴി റിപ്പോർട്ടുകൾ റൂട്ട് ചെയ്യുകയും HTTP പ്രോട്ടോക്കോൾ ഉപയോഗിച്ച് സേവന ദാതാവിന് അയയ്ക്കുകയും ചെയ്യുന്നു.
റിപ്പോർട്ടുകൾ ലഭിക്കാൻ, സേവന ദാതാവ് എക്സ്ampഒരു Java Servlet അല്ലെങ്കിൽ ASP.NET പേജ് നൽകുക. രണ്ടും HTTP GET അല്ലെങ്കിൽ POST അഭ്യർത്ഥനകൾ സ്വീകരിക്കുന്നു.
പരാമീറ്ററുകൾ
അഭ്യർത്ഥനയിൽ ഇനിപ്പറയുന്ന പാരാമീറ്ററുകൾ ഉൾപ്പെടുന്നു:
| പരാമീറ്റർ | ടൈപ്പ് ചെയ്യുക | M/O/I* | ഡിഫോൾട്ട് മൂല്യം | പരമാവധി നീളം | വിവരണം |
| മെസേജ് ഐഡി | ചരട് | M | – | 22 | ഈ റിപ്പോർട്ട് പൊരുത്തപ്പെടുന്ന MT സന്ദേശത്തിൻ്റെ സന്ദേശ ഐഡി. |
| ലക്ഷ്യ വിലാസം | ചരട് | M | – | 40 | ഉപഭോക്താവിൻ്റെ MSISDN, അതായത് യഥാർത്ഥ MT സന്ദേശത്തിൻ്റെ ലക്ഷ്യസ്ഥാന വിലാസം. |
| സ്റ്റാറ്റസ് കോഡ് | പൂർണ്ണസംഖ്യ | M | 1 | സ്റ്റാറ്റസ് കോഡ് എംടി സന്ദേശത്തിൻ്റെ നില സൂചിപ്പിക്കുന്നു. ബാധകമായ സ്റ്റാറ്റസ് കോഡുകൾ ഇവയാണ്: 0 - വിതരണം ചെയ്തു 2 - ഇല്ലാതാക്കി (കാരണ കോഡ് ബാധകമാണ്) |
|
| TimeStamp | ചരട് | M | – | 20 | LINK മൊബിലിറ്റിക്ക് ഡെലിവറി റിപ്പോർട്ട് എപ്പോൾ ലഭിച്ചുവെന്ന് സൂചിപ്പിക്കുന്ന സമയം. സമയത്തിൻ്റെ സമയ മേഖലamp CET അല്ലെങ്കിൽ CEST ആണ് (ഇയുവിനായി നിർവചിച്ചിരിക്കുന്ന വേനൽക്കാല സമയം). ഫോർമാറ്റ്: yyyyMMdd HH:mm:ss. |
| ഓപ്പറേറ്റർ | ചരട് | M | – | 100 | SMS സന്ദേശം അയയ്ക്കുമ്പോൾ ഉപയോഗിക്കുന്ന ഓപ്പറേറ്ററുടെ പേരോ SMS സന്ദേശം അയയ്ക്കുമ്പോൾ ഉപയോഗിക്കുന്ന അക്കൗണ്ടിൻ്റെ പേരോ. ലഭ്യമായ ഓപ്പറേറ്റർമാരുടെ ഒരു ലിസ്റ്റ് LINK മൊബിലിറ്റി പിന്തുണ നൽകുന്നു. |
| കാരണകോഡ് | പൂർണ്ണസംഖ്യ | 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. |
| സ്റ്റാറ്റസ് ടെക്സ്റ്റ് | ചരട് | O | – | 255 | ഓപ്പറേറ്ററിൽ നിന്നുള്ള അധിക വിവരങ്ങൾക്കുള്ള പ്ലെയ്സ്ഹോൾഡർ, ഉദാ സ്റ്റാറ്റസ്/കാരണത്തിൻ്റെ വ്യക്തമായ ടെക്സ്റ്റ് വിവരണം. ഓപ്പറേറ്റർ സംയോജനങ്ങൾ അനുസരിച്ച് പെരുമാറ്റം വ്യത്യാസപ്പെടാം. |
| കോറിലേഷൻ ഐഡി | ചരട് | O | – | 100 | SendRequest അല്ലെങ്കിൽ SendTextRequest-ൽ നൽകിയിരിക്കുന്ന പരസ്പര ബന്ധ ഐഡി. |
| ഓപ്പറേറ്റർ നെറ്റ്വർക്ക് കോഡ് | പൂർണ്ണസംഖ്യ | O | – | 6 | ഓപ്പറേറ്ററുടെ മൊബൈൽ നെറ്റ്വർക്ക് കോഡ് (MCC + MNC). |
* M = നിർബന്ധം, O = ഓപ്ഷണൽ, I = അവഗണിച്ചു.
സേവന ദാതാവ് ലക്ഷ്യത്തിനൊപ്പം LINK മൊബിലിറ്റി നൽകണം 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 മൊബിലിറ്റിക്ക് ഡെലിവറി റിപ്പോർട്ടുകൾക്കായി 30 സെക്കൻഡ് റെഡ് ടൈംഔട്ട് ഉണ്ട്. കാലഹരണപ്പെട്ടാൽ, ഡെലിവറി പുനഃശ്രമം (വീണ്ടും ശ്രമിക്കുക പ്രവർത്തനക്ഷമമാക്കിയിട്ടുണ്ടെങ്കിൽ) അല്ലെങ്കിൽ ഡെലിവറി റദ്ദാക്കൽ (വീണ്ടും ശ്രമിക്കുക പ്രവർത്തനരഹിതമാക്കിയാൽ) ട്രിഗർ ചെയ്യും. ഇതിനർത്ഥം സേവന ദാതാവിൻ്റെ ആപ്ലിക്കേഷൻ വേഗത്തിലുള്ള പ്രതികരണ സമയം ഉറപ്പാക്കണം, പ്രത്യേകിച്ച് ഉയർന്ന ലോഡ് സമയത്ത്.
LINK മൊബിലിറ്റിയിലേക്കുള്ള ഡെലിവറി റിപ്പോർട്ട് പ്രോസസ്സ് ചെയ്യുന്നതിന് മുമ്പ് അത് അംഗീകരിക്കാൻ വളരെ ശുപാർശ ചെയ്യുന്നു.
പോസിറ്റീവ്, നെഗറ്റീവ് അംഗീകാരത്തിനുള്ള നിയമം ഇനിപ്പറയുന്ന രീതിയിൽ വിവരിച്ചിരിക്കുന്നു:
പോസിറ്റീവ് അംഗീകാരം, ACK, ഡെലിവറി റിപ്പോർട്ട് കൈമാറി:
ഇനിപ്പറയുന്ന XML ഫോർമാറ്റ് ചെയ്ത ഉള്ളടക്കവുമായി സംയോജിപ്പിച്ച് HTTP 200 ശ്രേണി പ്രതികരണ കോഡ്:
നെഗറ്റീവ് അക്നോളജ്മെൻ്റ്, NAK, ഡെലിവറി റിപ്പോർട്ട് കൈമാറിയില്ല:
പോസിറ്റീവ് അംഗീകാരമല്ലാതെ മറ്റേതെങ്കിലും മറുപടി, ഉദാഹരണത്തിന്ample, ഏതെങ്കിലും HTTP പിശക് കോഡ് അല്ലെങ്കിൽ ഇനിപ്പറയുന്ന XML ഉള്ളടക്കം നിഷേധാത്മകമായ അംഗീകാരം പ്രവർത്തനക്ഷമമാക്കുന്നു:
LINK മൊബിലിറ്റി വീണ്ടും ശ്രമിക്കുന്നതിനുള്ള സംവിധാനം നിയന്ത്രിക്കുന്നതിന് XML ഉള്ളടക്കം ഉപയോഗിക്കാം. പ്രവർത്തനക്ഷമമാക്കിയാൽ ഒരു NAK വീണ്ടും ശ്രമിക്കുന്നതിന് കാരണമാകും. വീണ്ടും ശ്രമിക്കുന്നതിനുള്ള സംവിധാനത്തിനായി കോൺഫിഗർ ചെയ്തിട്ടില്ലാത്ത സേവന ദാതാക്കൾക്ക്, XML ഉള്ളടക്കം ഓപ്ഷണലാണ്.
താഴെ ഒരു HTTP POST അഭ്യർത്ഥനയും പ്രതികരണവും ഉണ്ട് exampഒരു സേവന ദാതാവിന് കൈമാറിയ ഡെലിവറി റിപ്പോർട്ടിൻ്റെ le:
HTTP അഭ്യർത്ഥന:
പോസ്റ്റ് / സന്ദർഭം/ആപ്പ് HTTP/1.1
ഉള്ളടക്ക തരം: അപ്ലിക്കേഷൻ / x-www-form-urlഎൻകോഡ് ചെയ്തത്;അക്ഷരക്രമം=utf-8
ഹോസ്റ്റ്: സെർവർ: പോർട്ട്
ഉള്ളടക്ക ദൈർഘ്യം: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
HTTP പ്രതികരണം:
HTTP/1.1 200 ശരി
ഉള്ളടക്ക-തരം: ടെക്സ്റ്റ്/പ്ലെയിൻ
9.2 വീണ്ടും ശ്രമിക്കുക
LINK മൊബിലിറ്റി സിസ്റ്റത്തിന് പരാജയപ്പെട്ട, അതായത് അംഗീകരിക്കപ്പെടാത്ത, ഡെലിവറി റിപ്പോർട്ട് ഡെലിവറികൾക്ക് വീണ്ടും ശ്രമിക്കാനാകും. സേവന ദാതാവിന് ഇഷ്ടപ്പെട്ട പുനഃശ്രമ സ്വഭാവം തിരഞ്ഞെടുക്കാനാകും:
വീണ്ടും ശ്രമിച്ചില്ല (സ്ഥിരസ്ഥിതി) - കണക്ഷൻ ശ്രമം പരാജയപ്പെടുകയോ സമയപരിധി വായിക്കുകയോ ഏതെങ്കിലും HTTP പിശക് കോഡിനായി സന്ദേശം നിരസിക്കപ്പെടും.
വീണ്ടും ശ്രമിക്കുക - എല്ലാ തരത്തിലുള്ള കണക്ഷൻ പ്രശ്നങ്ങൾക്കും, റീഡ് ടൈംഔട്ടിനും അല്ലെങ്കിൽ നെഗറ്റീവ് അംഗീകാരത്തിനും സന്ദേശം വീണ്ടും അയയ്ക്കും.
NAK-യ്ക്കുള്ള വീണ്ടും ശ്രമം പ്രവർത്തനക്ഷമമാക്കുമ്പോൾ, LINK മൊബിലിറ്റിയിൽ നിന്ന് ഒരു പുനഃശ്രമശ്രമം സൃഷ്ടിക്കുന്ന സാഹചര്യങ്ങൾ ഏതൊക്കെയാണെന്നും വീണ്ടും ശ്രമം എങ്ങനെ പ്രവർത്തിക്കുന്നുവെന്നും മനസ്സിലാക്കേണ്ടത് പ്രധാനമാണ്. ഓരോ സേവന ദാതാവിനും അതിൻ്റേതായ വീണ്ടും ശ്രമിക്കാനുള്ള ക്യൂ ഉണ്ട്, അവിടെ സന്ദേശ സമയം അനുസരിച്ച് സന്ദേശങ്ങൾ ഓർഡർ ചെയ്യപ്പെടുന്നുamp. സേവന ദാതാവിന് ഡെലിവർ ചെയ്യുന്ന സന്ദേശങ്ങളുടെ വ്യക്തിഗത ക്രമം ഉറപ്പില്ലെങ്കിലും, ലിങ്ക് മൊബിലിറ്റി എല്ലായ്പ്പോഴും പഴയ സന്ദേശങ്ങൾ ആദ്യം കൈമാറാൻ ശ്രമിക്കുന്നു. റിട്രി ക്യൂവിൽ നിന്ന് സന്ദേശങ്ങൾ നിരസിക്കപ്പെടുന്നതിനുള്ള പ്രധാന കാരണം രണ്ട് കാരണങ്ങളിൽ ഒന്നാണ്: ഒന്നുകിൽ സന്ദേശം TTL കാലഹരണപ്പെടും അല്ലെങ്കിൽ (സൈദ്ധാന്തികമായി) വീണ്ടും ശ്രമിക്കാനുള്ള ക്യൂ പൂർണ്ണമാകും. TTL എന്നത് ഓപ്പറേറ്ററും അക്കൗണ്ട് ആശ്രിതവുമാണ്, അതായത്, ഓപ്പറേറ്റർ അല്ലെങ്കിൽ സന്ദേശ തരത്തെ ആശ്രയിച്ച് വ്യത്യാസപ്പെടാം, ഉദാ, പ്രീമിയം SMS അല്ലെങ്കിൽ സാധാരണ നിരക്ക് SMS സന്ദേശം.
സന്ദേശം ഇതിനകം ലഭിച്ചിട്ടില്ലെന്ന് ഉറപ്പാക്കാൻ, വീണ്ടും ശ്രമിക്കുക പ്രവർത്തനക്ഷമമാക്കിയ ഒരു സേവന ദാതാക്കൾ MT സന്ദേശത്തിൻ്റെ തനത് ഐഡി പരിശോധിക്കണം.
ഒരു ഡെലിവറി റിപ്പോർട്ട് പ്രോസസ്സ് ചെയ്യുന്നതിനിടയിൽ ഒരു പിശക് സംഭവിക്കുമ്പോൾ ഈ ലളിതമായ നിയമങ്ങൾ പാലിക്കേണ്ടത് സേവന ദാതാവിന് പ്രധാനമാണ്, പിശകിൻ്റെ കാരണം ഇതാണ്: താത്കാലികം, ഉദാഹരണത്തിന് ഡാറ്റാബേസ് ലഭ്യമല്ല, ഒരു NAK തിരികെ നൽകണം. LINK മൊബിലിറ്റി സന്ദേശം വീണ്ടും അയയ്ക്കും.
ശാശ്വതവും വീണ്ടും ശ്രമിക്കാനുള്ള ശ്രമവും ഒരേ തരത്തിലുള്ള പ്രശ്നമുണ്ടാക്കാൻ സാധ്യതയുണ്ട്, ഒരു ACK തിരികെ നൽകണം. ഉദാample, സന്ദേശം ശരിയായി പാഴ്സ് ചെയ്യാൻ കഴിയാത്തപ്പോൾ അല്ലെങ്കിൽ ഒരു അപ്രതീക്ഷിത റൺടൈം പിശക് സംഭവിക്കുമ്പോൾ.
അതനുസരിച്ച് പ്രവർത്തിക്കുന്നത്, ഒരു ഡെലിവറി റിപ്പോർട്ട് ആവർത്തിച്ച് വീണ്ടും അയയ്ക്കുന്നതിനാൽ തടസ്സമോ ത്രൂപുട്ട് ഡീഗ്രേഡേഷനോ ഉണ്ടാകുന്നില്ലെന്ന് ഉറപ്പാക്കും.
10. നടപ്പാക്കൽ നുറുങ്ങുകൾ
1. നിങ്ങളുടെ ഉപയോഗിക്കാൻ സാധ്യമാണ് web API-ലേക്ക് അഭ്യർത്ഥനകൾ സമർപ്പിക്കാൻ ബ്രൗസർ. വികസന ഉപകരണങ്ങളൊന്നും കൂടാതെ സേവനങ്ങൾ പര്യവേക്ഷണം ചെയ്യുന്നതും വിലയിരുത്തുന്നതും ഇത് വളരെ എളുപ്പമാക്കുന്നു.
2. JSON പോലുള്ള ഒരു വിപുലീകരണത്തോടൊപ്പം Chrome അല്ലെങ്കിൽ Firefox ശുപാർശ ചെയ്യുന്നുView മനോഹരമായി ഫോർമാറ്റ് ചെയ്ത JSON പ്രദർശിപ്പിക്കാൻ.
3. POST, അടിസ്ഥാന പ്രാമാണീകരണം, റോ എച്ച്ടിടിപി അഭ്യർത്ഥന, പ്രതികരണ സന്ദേശങ്ങൾ എന്നിവ പരിശോധിക്കുന്നതിന് ഞങ്ങൾ SoapUI ഉപയോഗിച്ചു.
4. സിURL അടിസ്ഥാന പ്രാമാണീകരണത്തോടുകൂടിയ POST അഭ്യർത്ഥനകൾ സമർപ്പിക്കുന്നതിന് ഉപകരണം ഉപയോഗപ്രദമാണ്. മുൻ കാണുകampതാഴെ.
curl പോസ്റ്റ് \
-എച്ച് “ഉള്ളടക്ക-തരം: അപേക്ഷ/x-www-ഫോം-urlഎൻകോഡ് ചെയ്തു” \
-H “അംഗീകാരം: അടിസ്ഥാന am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–data “destinationAddress=46123456789&messageText=Hello+World%21”
_______________
വ്യക്തിഗത ആശയവിനിമയങ്ങൾ പരിവർത്തനം ചെയ്യുന്നു
പ്രമാണങ്ങൾ / വിഭവങ്ങൾ
 |
ലിങ്ക് മൊബിലിറ്റി ഇംപ്ലിമെൻ്റേഷൻ ഗൈഡ് REST API SMS [pdf] ഉപയോക്തൃ ഗൈഡ് മൊബിലിറ്റി ഇംപ്ലിമെൻ്റേഷൻ ഗൈഡ് REST API SMS, മൊബിലിറ്റി, ഇംപ്ലിമെൻ്റേഷൻ ഗൈഡ് REST API SMS, REST API SMS, API SMS, SMS |
