SMS API, SMPP API MS Scheduler API
Օգտագործողի ուղեցույց
SMS API, SMPP API MS Scheduler API
| Փոփոխված՝ | 6/24/2025 |
| Տարբերակ: | 1.7 |
| Հեղինակ: | Քենի Քոլանդեր Նորդեն, KCN |
Այս փաստաթուղթը նախատեսված է միայն նշանակված ստացողի համար և կարող է պարունակել արտոնյալ, սեփականության կամ այլ կերպ անձնական տեղեկատվություն: Եթե այն սխալմամբ եք ստացել, խնդրում ենք անմիջապես տեղեկացնել ուղարկողին և ջնջել բնօրինակը: Ձեր կողմից փաստաթղթի ցանկացած այլ օգտագործում արգելվում է:
Փոխել պատմությունը
| Վեր | Ամսաթիվ | 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-ն SMS դիստրիբյուտոր է 2001 թվականից և ունի ինչպես օպերատորների, այնպես էլ կապի ագրեգատորների հետ աշխատելու մեծ փորձ: Այս հարթակը նախատեսված է մեծ երթևեկության ծավալները սպասարկելու, բարձր հասանելիություն պահպանելու և բազմաթիվ կապերի միջոցով երթևեկությունը հեշտացնելու համար:
Այս փաստաթուղթը նկարագրում է SMPP ինտերֆեյսը SMSC հարթակի հետ և թե որ պարամետրերն ու հրամաններն են անհրաժեշտ, ինչպես նաև որ պարամետրերն են աջակցվում։
Այս փաստաթուղթը չի անդրադառնա կոնկրետ օգտագործման դեպքերին, ինչպիսիք են միացված հաղորդագրությունները, WAPpush-ը, Flash SMS-ը և այլն: Այդ դեպքերի մասին լրացուցիչ տեղեկություններ կարող եք ստանալ՝ կապվելով աջակցության ծառայության հետ:
Աջակցվող հրամաններ
LINK Mobility-ի սերվերը պետք է դիտարկվի որպես SMPP 3.4: Պաշտոնական բնութագրերը կարելի է գտնել այստեղ https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Բոլոր մեթոդները չեն ապահովվում, և բոլոր տարբերությունները նշված են ստորև:
4.1 Կապել
Հետևյալ կապի հրամանները աջակցվում են.
- Հաղորդիչ
- Տրանսցիվեր
- Ընդունիչ
Պահանջվող պարամետրեր.
- 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_length
- կարճ_հաղորդագրություն
Չաջակցվող պարամետրեր.
- ծառայության_տեսակ
- protocol_id
- priority_flag
- ժամանակացույց_առաքման_ժամանակ
- replace_if_present_flag
- sm_default_msg_id
Նշում որ օգտակար բեռը tag չի աջակցվում, և յուրաքանչյուր զանգի համար կարող է առաքվել միայն մեկ SMS, և խորհուրդ է տրվում, որ վավերականության_ժամկետը tag ունի առնվազն 15 րոպե արժեք:
4.4.1 Առաջարկվող TON և NPI
Հետևյալ TON-ը և NPI-ը պետք է օգտագործվեն ուղարկելու հրամանի միջոցով հաղորդագրություններ ուղարկելիս:
4.4.1.1 Աղբյուր
Աղբյուրի հասցեի համար աջակցվում են հետևյալ TON և NPI համակցությունները: Մնացած բոլոր համակցությունները կհամարվեն անվավեր: Եթե TON-ը սահմանված է Անհայտ (0), կօգտագործվի կապման հրամանից ստացված TON-ը: Եթե NPI-ն սահմանված է Անհայտ (0), կօգտագործվի կապման հրամանից ստացված NPI-ը:
| ՏՈՆ | NPI | Նկարագրություն |
| Ալֆան-թվային (5) | Անհայտ (0) ISDN (1) |
Կդիտարկվի որպես Ալֆանա-թվային ուղարկողի տեքստ |
| Միջազգային (1) | Անհայտ (0) ISDN (1) |
Կդիտարկվի որպես MSISDN |
| Ազգային (2) Ցանցին բնորոշ (3) Բաժանորդի համարը (4) Կրճատված (6) |
Անհայտ (0) ISDN (1) Ազգային (8) |
Կդիտարկվի որպես երկրի հատուկ կարճ համար: |
4.4.1.2 Նպատակակետը
Հետևյալ TON և NPI համակցությունները աջակցվում են նպատակակետ հասցեի համար: Մնացած բոլոր համակցությունները կհամարվեն անվավեր: Կանխադրված TON-ից bind հրամանը կօգտագործվի, եթե TON-ը սահմանվի Անհայտ (0): Լռելյայն NPI-ից bind հրամանը կօգտագործվի, եթե NPI-ը սահմանվի Անհայտ (0):
| ՏՈՆ | NPI | Նկարագրություն |
| Միջազգային (1) | Անհայտ (0) ISDN (1) |
Կդիտարկվի որպես MSISDN |
4.4.2 Աջակցվող կոդավորումներ
Աջակցվում են հետևյալ կոդավորումները. X-ը կարող է պարունակել ցանկացած արժեք:
| DCS | Կոդավորում |
| 0xX0 | Կանխադրված GSM այբուբեն ընդլայնմամբ |
| 0xX2 | 8-բիթանոց երկուական |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Քվոտա
5.1 Քվոտա գերազանցելըview
Քվոտան սահմանում է SMS հաղորդագրությունների առավելագույն քանակը, որոնք կարող են ուղարկվել որոշակի ժամանակահատվածում (օրինակ՝ օրական, շաբաթական, ամսական կամ անորոշ ժամանակով): Յուրաքանչյուր քվոտա եզակիորեն նույնականացվում է quotaId-ով (UUID) և վերակայվում է հաճախորդի ժամային գոտուն համապատասխան: Քվոտաները կարող են նշանակվել երկրի, տարածաշրջանի կամ լռելյայն մակարդակի վրա՝ Quota Pro-ի միջոցով:fileՔվոտան կարող է նաև դինամիկ կերպով վերագրվել Քվոտայի քարտեզագրման միջոցով: Սա կապում է ծնողական QuotaId-ը (UUID) և եզակի քվոտայի բանալի (օրինակ՝ ուղարկող կամ օգտատեր) որոշակի քվոտայիId-ի հետ:
Քվոտան սահմանվում է ձեր տեղական աջակցության ծառայության, ձեր նշանակված հաշվի կառավարչի համաձայն կամ լռելյայնորեն, եթե ոչինչ նշված չէ։
5.2 Կարգավիճակ 106 – Քվոտան գերազանցված է
SMS հաղորդագրությունը կարող է արգելափակվել 106 կարգավիճակի կոդով («քվոտան գերազանցվել է»), երբ՝
- Հաղորդագրությունը գերազանցում է համապատասխան քվոտաի նույնականացուցիչի (quotaId) սահմանված սահմանաչափը ընթացիկ ժամանակահատվածում։
- Նպատակակետային երկիրը կամ տարածաշրջանը չունի նշանակված քվոտա (այսինքն՝ հստակորեն արգելափակված է պրո-ում զրոյական քվոտաների քարտեզագրմամբ)file).
- Համապատասխանող քվոտա չկա և լռելյայն քվոտա սահմանված չէ, ինչը հանգեցնում է մերժման։
Այս դեպքերում համակարգը կանխում է հաղորդագրությունների հետագա մշակումը՝ հաճախորդի կամ նպատակակետի վրա հիմնված սահմանափակումները կիրառելու և չարաշահումը կանխելու համար։
Առաքման զեկույցը
Աջակցվում է միայն ոչ մեկը կամ վերջնական առաքումը հաջող/ձախողված արդյունքով:
Ձեւաչափը առաքման մասին հաշվետվության վրա. ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXx Կատարված ամսաթիվ `YymMdhhmm Stat:
Հասանելի արժեքները կարգավիճակում.
- ԴԵԼԻՎՐԴ
- ԺԱՄԱՆԱԿԸ ՍՊԱՆՎԵԼ Է
- ՄԵՐԺՎԵԼ Է
- ՉԺԱՄԱՆԱԿՎԵԼ
- ՋՆՋՎԱԾ
6.1 Ընդլայնված առաքման հաշվետվության ձևաչափ
Առաքման հաշվետվություններում ընդլայնված տեղեկատվություն կարող է պահանջվել ձեր վաճառքի ներկայացուցչի հետ կապ հաստատելու համար:
Առաքման հաշվետվության ձևաչափը՝ id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 ուղարկման ամսաթիվ:
yyMMddHHmm ավարտի ամսաթիվ՝ yyMMddHHmm վիճակ՝ սխալ: տեքստ՝
Հասանելի արժեքները կարգավիճակում.
- ԴԵԼԻՎՐԴ
- ԺԱՄԱՆԱԿԸ ՍՊԱՆՎԵԼ Է
- ՄԵՐԺՎԵԼ Է
- ՉԺԱՄԱՆԱԿՎԵԼ
- ՋՆՋՎԱԾ
«sub» և «dlvrd» դաշտերը միշտ սահմանվելու են 000, իսկ «տեքստային» դաշտերը միշտ դատարկ կլինեն:
Տես «սխալ» դաշտի արժեքների սխալի կոդերը:
Աջակցված TLS տարբերակները
TLS 1.2 կամ TLS 1.3 պահանջվում է SMPP-ով բոլոր TLS միացումների համար:
TLS 1.0-ի և 1.1-ի աջակցությունը դադարեցված է 2020-11-15-ից: TLS-ի 1.0 և 1.1 տարբերակներն ավելի հին արձանագրություններ են, որոնք հնացած են և համարվում են անվտանգության ռիսկեր ինտերնետ համայնքում:
LINK-ը խստորեն խորհուրդ է տալիս օգտագործել TLS, եթե այսօր օգտագործվում են չգաղտնագրված SMPP կապեր: Չկոդավորված SMPP կապերը հնացած են 2020-09-01-ից սկսած LINK-ի կողմից և հետագայում կհեռացվեն: Չկոդավորված կապերի հեռացման ամսաթիվը դեռ որոշված չէ:
TLS-ի համար SMPP սերվերի հետ կապերը 3601 նավահանգստում են՝ 3600 նավահանգստում չգաղտնագրվածի փոխարեն:
Դուք դեռ կարող եք օգտագործել TLS, նույնիսկ եթե ձեր SMPP իրականացումը չի աջակցում TLS-ը stunnel-ի միջոցով, տես https://www.stunnel.org/
Սխալի կոդերը
Հետևյալ սխալի կոդերը կարող են պատասխանել err դաշտում, եթե դաշտը միացված է:
| Սխալի կոդը | Նկարագրություն |
| 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 | Alpha-ն չի աջակցվում որպես աղբյուր |
| 2003 | MSISDN-ը չի աջակցվում որպես աղբյուրի համար |
| 2100 | Կարճ համարը չի աջակցվում որպես նպատակակետ |
| 2101 | Alpha-ն չի աջակցվում որպես նպատակակետ |
| 2102 | MSISDN-ը չի աջակցվում որպես նպատակակետ |
| 2103 | Գործողությունն արգելափակված է |
| 2104 | Անհայտ բաժանորդ |
| 2105 | Ուղղությունը արգելափակված է |
| 2106 | Թվի սխալ |
| 2107 | Նպատակակետը ժամանակավորապես արգելափակված է |
| 2108 | Անվավեր նպատակակետ |
| 2200 | Լիցքավորման սխալ |
| 2201 | Բաժանորդը ցածր մնացորդ ունի |
|
2202 |
Բաժանորդը արգելափակվել է գերվճարման պատճառով (պրեմիում)
հաղորդագրություններ |
|
2203 |
Բաժանորդը չափազանց երիտասարդ է (այս կոնկրետ դեպքում)
բովանդակություն) |
| 2204 | Կանխավճարային բաժանորդը չի թույլատրվում |
| 2205 | Ծառայությունը մերժվել է բաժանորդի կողմից |
| 2206 | Վճարային համակարգում գրանցված բաժանորդ |
| 2207 | Բաժանորդը հասել է առավելագույն մնացորդի |
| 2208 | Անհրաժեշտ է վերջնական օգտագործողի հաստատում |
| 2300 | Վերադարձվել է |
|
2301 |
Հնարավոր չէ վերադարձնել ապրանքը անօրինական կամ բացակայող պատճառով
MSISDN |
| 2302 | Չհաջողվեց վերադարձնել գումարը բաց թողնված հաղորդագրության ID-ի պատճառով |
| 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 |