SMS API, SMPP API MS Scheduler API
පරිශීලක මාර්ගෝපදේශය
SMS API, SMPP API MS Scheduler API
| වෙනස් කරන ලද: | 6/24/2025 |
| අනුවාදය: | 1.7 |
| කර්තෘ: | කෙනී කොලන්ඩර් නෝර්ඩන්, KCN |
මෙම ලේඛනය නම් කරන ලද ලබන්නා සඳහා පමණක් වන අතර වරප්‍රසාදිත, හිමිකාර හෝ වෙනත් පුද්ගලික තොරතුරු අඩංගු විය හැක. ඔබට එය වැරදීමකින් ලැබී ඇත්නම්, කරුණාකර යවන්නාට වහාම දන්වා මුල් පිටපත මකා දමන්න. ඔබ විසින් ලේඛනය වෙනත් ඕනෑම භාවිතයක් තහනම්ය.
ඉතිහාසය වෙනස් කරන්න
| Rev | දිනය | By | පෙර නිකුතුවෙන් වෙනස්කම් |
| 1.0 | 2010-03-16 | KCN | නිර්මාණය කළා |
| 1. | 2019-06-11 | TPE | LINK ලාංඡන යාවත්කාලීන කරන ලදී |
| 1. | 2019-09-27 | PNI | SMPP 3.4 පිරිවිතර වෙත යොමු එකතු කරන ලදී |
| 1. | 2019-10-31 | EP | වලංගු කාලය පිළිබඳ නිරීක්ෂණය tag |
| 1. | 2020-08-28 | KCN | සහාය දක්වන TLS අනුවාද පිළිබඳ තොරතුරු එක් කරන ලදී |
| 2. | 2022-01-10 | KCN | බෙදාහැරීමේ වාර්තා සම්බන්ධයෙන් අමතර තොරතුරු එක් කරන ලදී. TLS 1.3 සම්බන්ධයෙන් යාවත්කාලීන කරන ලද තොරතුරු |
| 2. | 2025-06-03 | GM | ප්‍රතිඵල කේතය 2108 එකතු කරන ලදී |
| 2. | 2025-06-24 | AK | කෝටාව එකතු කරන ලදී |
හැඳින්වීම
LINK Mobility 2001 සිට SMS බෙදාහරින්නෙකු වන අතර ක්‍රියාකරුවන් සහ සම්බන්ධතා එකතුකරන්නන් යන දෙකම සමඟ වැඩ කිරීමේ බොහෝ අත්දැකීම් ඇත. මෙම වේදිකාව සැලසුම් කර ඇත්තේ විශාල රථවාහන පරිමාවන් හැසිරවීමට, ඉහළ උපයෝගිතාවයක් පවත්වා ගැනීමට සහ බහු සම්බන්ධතා හරහා ගමනාගමනය පහසු කිරීමටය.
මෙම ලේඛනය SMSC-වේදිකාවට SMPP අතුරුමුහුණත සහ අවශ්ය පරාමිතීන් සහ විධාන සහ සහාය දක්වන පරාමිතීන් විස්තර කරයි.
මෙම ලේඛනය සංයුක්ත පණිවිඩ, WAPpush, Flash SMS යනාදී නිශ්චිත භාවිත අවස්ථා හසුරුවන්නේ නැත. එම අවස්ථා පිළිබඳ වැඩිදුර තොරතුරු සහාය සම්බන්ධ කර ගැනීමෙන් ලබා දිය හැක.
සහාය දක්වන විධාන
LINK Mobility හි සේවාදායකය SMPP 3.4 ලෙස සැලකිය යුතුය. නිල පිරිවිතර සොයාගත හැකිය https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
සියලුම ක්‍රම සඳහා සහය නොදක්වන අතර, සියලු වෙනස්කම් පහත දක්වා ඇත.
4.1 බඳින්න
පහත bind විධානයන් සඳහා සහය දක්වයි.
- සම්ප්රේෂකය
- සම්ප්රේෂකය
- ග්රාහකයා
අවශ්ය පරාමිතීන්:
- system_id - සහායෙන් ලබාගත්
- මුරපදය - සහායෙන් ලබාගත්
විකල්ප පරාමිතීන්:
- addr_ton - ඉදිරිපත් කිරීමේදී TON නොදන්නා ලෙස සකසා ඇත්නම් පෙරනිමි අගය.
- addr_npi - ඉදිරිපත් කිරීමේදී NPI නොදන්නා ලෙස සකසා ඇත්නම් පෙරනිමි අගය.
සහාය නොදක්වන පරාමිති:
- ලිපිනය_පරාසය
4.2 නොබැඳීම
Unbind විධානය සහය දක්වයි.
4.3 විමසන්න සබැඳිය
විමසීම් සම්බන්ධක විධානය සඳහා සහය දක්වන අතර සෑම තත්පර 60 කට වරක් ඇමතීමට සිදුවේ.
4.4 ඉදිරිපත් කරන්න
පණිවිඩ යැවීම සඳහා ඉදිරිපත් කිරීමේ ක්‍රමය භාවිතා කළ යුතුය.
අවශ්ය පරාමිතීන්:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- දත්ත_කේතනය
- sm_දිග
- කෙටි_පණිවිඩය
සහාය නොදක්වන පරාමිති:
- සේවා_වර්ගය
- protocol_id
- ප්රමුඛතා_ධජය
- කාලසටහන්_බෙදා හැරීමේ_කාලය
- ප්‍රතිස්ථාපනය_නම්_දැන්_කොඩිය
- sm_default_msg_id
සටහන ගෙවීමේ බර බව tag සහාය නොදක්වන අතර එක් ඇමතුමකට එක් කෙටි පණිවුඩයක් පමණක් ලබා දිය හැකි අතර වලංගු_කාලසීමාව නිර්දේශ කෙරේ tag අවම වශයෙන් විනාඩි 15 ක අගයක් ඇත.
4.4.1 නිර්දේශිත TON සහ NPI
submit විධානය භාවිතයෙන් පණිවිඩ යැවීමේදී පහත TON සහ NPI භාවිතා කළ යුතුය.
4.4.1.1 මූලාශ්රය
පහත TON සහ NPI සංයෝජන මූලාශ්‍ර ලිපිනය සඳහා සහය දක්වයි. අනෙකුත් සියලුම සංයෝජන අවලංගු ලෙස සලකනු ලැබේ. TON නොදන්නා (0) ලෙස සකසා ඇත්නම් bind විධානයෙන් පෙරනිමි TON භාවිතා කරනු ලැබේ. NPI නොදන්නා (0) ලෙස සකසා ඇත්නම් bind විධානයෙන් පෙරනිමි NPI භාවිතා කරනු ලැබේ.
| ටොන් | NPI | විස්තරය |
| අක්ෂරාංක (5) | නොදන්නා (0) අයිඑස්ඩීඑන් (1) |
අක්ෂරාංක යවන්නාගේ පෙළ ලෙස සලකනු ලැබේ |
| ජාත්‍යන්තර (1) | නොදන්නා (0) අයිඑස්ඩීඑන් (1) |
MSISDN ලෙස සලකනු ලැබේ |
| ජාතික (2) ජාලයට විශේෂිත (3) ග්‍රාහක අංකය (4) කෙටියෙන් (6) |
නොදන්නා (0) අයිඑස්ඩීඑන් (1) ජාතික (8) |
රට විශේෂිත කෙටි අංකයක් ලෙස සලකනු ඇත. |
4.4.1.2 ගමනාන්තය
ගමනාන්ත ලිපිනය සඳහා පහත TON සහ NPI සංයෝජන සහාය දක්වයි. අනෙකුත් සියලුම සංයෝජන අවලංගු ලෙස සලකනු ලැබේ. TON නොදන්නා (0) ලෙස සකසා ඇත්නම් bind විධානයෙන් පෙරනිමි TON භාවිතා වේ. NPI නොදන්නා (0) ලෙස සකසා ඇත්නම් bind විධානයෙන් පෙරනිමි NPI භාවිතා වේ.
| ටොන් | NPI | විස්තරය |
| ජාත්‍යන්තර (1) | නොදන්නා (0) අයිඑස්ඩීඑන් (1) |
MSISDN ලෙස සලකනු ලැබේ |
4.4.2 සහය දක්වන කේතීකරණ
පහත කේතීකරණ සඳහා සහය දක්වයි. X හි ඕනෑම අගයක් අඩංගු විය හැක.
| DCS | කේතනය කිරීම |
| 0xX0 | දිගුව සමඟ පෙරනිමි GSM හෝඩිය |
| 0xX2 | 8-bit ද්විමය |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
කෝටාව
5.1 කෝටාව වැඩියිview
කෝටාවක් මඟින් නිශ්චිත කාල පරතරයක් තුළ (දිනකට, සතියකට, මාසයකට හෝ දින නියමයක් නොමැතිව) යැවිය හැකි උපරිම SMS පණිවිඩ ගණන නිර්වචනය කරයි. සෑම කෝටාවක්ම quotaId (UUID) මගින් අනන්‍ය ලෙස හඳුනාගෙන ඇති අතර පාරිභෝගිකයාගේ කාල කලාපය අනුව නැවත සකසනු ලැබේ. කෝටා ප්‍රෝ හරහා රට, කලාපය හෝ පෙරනිමි මට්ටමින් කෝටා පැවරිය හැක.file. Quota සිතියම්කරණය භාවිතයෙන් ගතිකව පවරනු ලැබිය හැකිය. මෙය මාපිය QuotaId (UUID) සහ අද්විතීය quota Key (උදා: යවන්නා හෝ පරිශීලකයා) නිශ්චිත quotaId එකකට සිතියම්ගත කරයි.
ඔබේ දේශීය සහාය, ඔබට පවරා ඇති ගිණුම් කළමනාකරු හෝ කිසිවක් නිශ්චිතව දක්වා නොමැති නම් පෙරනිමියෙන් කෝටාවක් සකසා ඇත.
5.2 තත්ත්වය 106 – කෝටාව ඉක්මවා ඇත
106 ("කෝටාව ඉක්මවා ඇත") තත්ව කේතය සහිත SMS පණිවිඩයක් අවහිර කළ හැක්කේ:
- පණිවිඩය වත්මන් පරතරය තුළ එහි අනුරූප quotaId සඳහා අර්ථ දක්වා ඇති සීමාව ඉක්මවා යයි.
- ගමනාන්ත රටට හෝ කලාපයට කෝටාවක් පවරා නැත (එනම්, pro හි ශුන්‍ය කෝටා සිතියම්ගත කිරීමකින් පැහැදිලිවම අවහිර කර ඇත)file).
- ගැළපෙන කෝටාවක් නොමැති අතර පෙරනිමි කෝටාවක් අර්ථ දක්වා නොමැති අතර, ප්‍රතිඵලයක් ලෙස ප්‍රතික්ෂේප වේ.
මෙම අවස්ථා වලදී, පාරිභෝගික හෝ ගමනාන්ත පාදක සීමාවන් බලාත්මක කිරීමට සහ අනිසි භාවිතය වළක්වා ගැනීමට පද්ධතිය තවදුරටත් පණිවිඩ සැකසීම වළක්වයි.
භාරදීමේ වාර්තාව
සාර්ථක/අසාර්ථක ප්‍රතිඵලයක් සහිත කිසිඳු හෝ අවසාන බෙදා හැරීමක් පමණක් සහාය නොදක්වයි.
බෙදා හැරීමේ වාර්තාව පිළිබඳ ආකෘතිය: ID: ID: Id: FXXXXXXXXux
තත්ත්‍වයේ පවතින අගයන්:
- DELIVRD
- කල් ඉකුත් විය
- ප්‍රතික්ෂේප කරනවා
- UNDELIV
- මකා දමන ලදී
6.1 විස්තීරණ බෙදාහැරීමේ වාර්තා ආකෘතිය
බෙදාහැරීමේ වාර්තාවල විස්තීරණ තොරතුරු ඔබේ විකුණුම් නියෝජිතයා සමඟ සම්බන්ධ වී ඉල්ලා සිටිය හැක.
බෙදාහැරීමේ වාර්තාවේ ආකෘතිය: id: xx උප: 000 dlvrd: 000 ඉදිරිපත් කළ දිනය:
yyMMddHHmm කළ දිනය: yyMMddHHmm stat: වැරදි: පෙළ:
තත්ත්‍වයේ පවතින අගයන්:
- DELIVRD
- කල් ඉකුත් විය
- ප්‍රතික්ෂේප කරනවා
- UNDELIV
- මකා දමන ලදී
"sub" සහ "dlvrd" ක්ෂේත්‍ර සෑම විටම 000 ලෙස සකසා ඇති අතර, "පෙළ" ක්ෂේත්‍රය සැමවිටම හිස් වනු ඇත.
"err" ක්ෂේත්‍රය සඳහා අගයන් සඳහා පරිච්ඡේද දෝෂ කේත බලන්න.
සහය දක්වන TLS අනුවාද
SMPP හරහා සියලුම TLS සම්බන්ධතා සඳහා TLS 1.2 හෝ TLS 1.3 අවශ්ය වේ.
TLS 1.0 සහ 1.1 සඳහා සහය 2020-11-15 සිට නතර කර ඇත. TLS හි 1.0 සහ 1.1 අනුවාද පැරණි ප්‍රොටෝකෝලයන් වන අතර ඒවා අවලංගු කර ඇති අතර අන්තර්ජාල ප්‍රජාව තුළ ආරක්ෂක අවදානම් ලෙස සැලකේ.
සංකේතනය නොකළ SMPP සම්බන්ධතා අද භාවිතා කරන්නේ නම් TLS භාවිතා කිරීමට LINK තරයේ නිර්දේශ කරයි. සංකේතනය නොකළ SMPP සම්බන්ධතා 2020-09-01 වන විට LINK මගින් අත්හරින ලද අතර අනාගතයේදී ඉවත් කරනු ලැබේ. සංකේතනය නොකළ සම්බන්ධතා ඉවත් කිරීමේ දිනය තවම තීරණය කර නැත.
TLS සඳහා SMPP සේවාදායකය වෙත සම්බන්ධතා වරාය 3601 හි සංකේතනය නොකළ වෙනුවට 3600 වරායේ ඇත.
ඔබේ SMPP ක්‍රියාත්මක කිරීම ස්ටනල් භාවිතයෙන් TLS සඳහා සහය නොදක්වන විට පවා ඔබට තවමත් TLS භාවිත කළ හැක, බලන්න https://www.stunnel.org/
දෝෂ කේත
ක්ෂේත්‍රය සක්‍රීය කර ඇත්නම් පහත දෝෂ කේත දෝෂ ක්ෂේත්‍රයේ පිළිතුරු සැපයිය හැක.
| දෝෂ කේතය | විස්තරය |
| 0 | නොදන්නා දෝෂයකි |
| 1 | තාවකාලික මාර්ග දෝෂයකි |
| 2 | ස්ථිර මාර්ගගත දෝෂයකි |
| 3 | උපරිම තෙරපුම ඉක්මවා ඇත |
| 4 | කාලය හමාරයි |
| 5 | ක්රියාකරු නොදන්නා දෝෂයකි |
| 6 | ක්රියාකරුගේ දෝෂයකි |
| 100 | සේවාව හමු නොවීය |
| 101 | පරිශීලක හමු නොවීය |
| 102 | ගිණුම් සොයාගත නොහැකි |
| 103 | වලංගු නොවන මුරපදයක් |
| 104 | වින්‍යාස දෝෂය |
| 105 | අභ්‍යන්තර දෝෂයක් |
| 106 | පංගුව ඉක්මවා ඇත |
| 200 | OK |
| 1000 | යවා ඇත |
| 1001 | භාර දුන්නා |
| 1002 | කල් ඉකුත් වී ඇත |
| 1003 | මකා දමන ලදී |
| 1004 | ජංගම දුරකථනය පිරී ඇත |
| 1005 | පෝලිමේ |
| 1006 | භාර දී නැත |
| 1007 | භාර දුන්නා, අයකිරීම ප්‍රමාදයි |
| 1008 | ආරෝපණය කර ඇත, පණිවිඩය යවා නැත |
| 1009 | ආරෝපණය කර ඇත, පණිවිඩය ලබා දී නැත |
| 1010 | කල් ඉකුත් වූ, ක්රියාකරු බෙදාහැරීමේ වාර්තාව නොමැති වීම |
| 1011 | ආරෝපණය, පණිවිඩය යවන ලදී (ක්රියාකරු වෙත) |
| 1012 | දුරස්ථව පෝලිමේ |
| 1013 | පණිවිඩය ක්රියාකරු වෙත යවන ලදි, අයකිරීම ප්‍රමාදයි |
| 2000 | වලංගු නොවන මූලාශ්‍ර අංකයක් |
| 2001 | කෙටි අංකය මූලාශ්රය ලෙස සහාය නොදක්වයි |
| 2002 | ඇල්ෆා මූලාශ්රය ලෙස සහාය නොදක්වයි |
| 2003 | MSISDN මූලාශ්‍ර අංකය ලෙස සහාය නොදක්වයි |
| 2100 | ගමනාන්තය ලෙස කෙටි අංකය සහාය නොදක්වයි |
| 2101 | ඇල්ෆා ගමනාන්තය ලෙස සහාය නොදක්වයි |
| 2102 | MSISDN ගමනාන්තය ලෙස සහාය නොදක්වයි |
| 2103 | මෙහෙයුම අවහිර කර ඇත |
| 2104 | නොදන්නා ග්රාහකයා |
| 2105 | ගමනාන්තය අවහිර කර ඇත |
| 2106 | අංක දෝෂය |
| 2107 | ගමනාන්තය තාවකාලිකව අවහිර කර ඇත |
| 2108 | අවලංගු ගමනාන්තයකි |
| 2200 | ආරෝපණ දෝෂයකි |
| 2201 | ග්‍රාහකයාට අඩු ශේෂයක් ඇත |
|
2202 |
වැඩිපුර අය කිරීම සඳහා ග්‍රාහකයාට තහනම් (වාරික)
පණිවිඩ |
|
2203 |
ග්රාහකයා ඉතා තරුණයි (මෙම විශේෂිත සඳහා
අන්තර්ගතය) |
| 2204 | පෙරගෙවුම් ග්‍රාහකයාට අවසර නැත |
| 2205 | සේවාව ග්රාහකයා විසින් ප්‍රතික්ෂේප කරන ලදී |
| 2206 | ග්රාහකයා ගෙවීම් පද්ධතියේ ලියාපදිංචි වී නොමැත |
| 2207 | ග්රාහකයා උපරිම ශේෂයට පැමිණ ඇත |
| 2208 | අවසාන පරිශීලක තහවුරු කිරීම අවශ්‍යයි |
| 2300 | ආපසු ගෙවන ලදී |
|
2301 |
නීති විරෝධී හෝ අස්ථානගත වීම නිසා මුදල් ආපසු ගෙවීමට නොහැකි විය.
MSISDN |
| 2302 | පණිවිඩ හැඳුනුම්පත අස්ථානගත වීම නිසා ආපසු ගෙවීමට නොහැකි විය |
| 2303 | මුදල් ආපසු ගැනීම සඳහා පෝලිම් ගැසී ඇත |
| 2304 | ආපසු ගෙවීමේ කල් ඉකුත්වීම |
| 2305 | ආපසු ගෙවීමේ අසාර්ථකත්වය |
| 3000 | GSM කේතනය සඳහා සහය නොදක්වයි |
| 3001 | UCS2 කේතනය සඳහා සහය නොදක්වයි |
| 3002 | ද්විමය කේතනය සඳහා සහය නොදක්වයි |
| 4000 | බෙදා හැරීමේ වාර්තාව සහාය නොදක්වයි |
| 4001 | වලංගු නොවන පණිවිඩ අන්තර්ගතය |
| 4002 | වලංගු නොවන ගාස්තු |
| 4003 | වලංගු නොවන පරිශීලක දත්ත |
| 4004 | වලංගු නොවන පරිශීලක දත්ත ශීර්ෂකය |
| 4005 | වලංගු නොවන දත්ත කේතනය |
| 4006 | වලංගු නොවන වැට් බද්ද |
| 4007 | ගමනාන්තය සඳහා සහය නොදක්වන අන්තර්ගතය |
ලේඛන / සම්පත්
 |
සම්බන්ධක සංචලතා SMS API, SMPP API MS Scheduler API [pdf] පරිශීලක මාර්ගෝපදේශය SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |