SMS API միջերես
SMS API՝ կայքերի, CMS և CRM համակարգերի համար։
Ի՞նչ հնարավորություններ եք ստանում
Մեկ ինտեգրմամբ կառավարեք գրանցման հաստատումը, գործարքային հաղորդագրությունները, OTP կոդերը, պլանավորված ուղարկումն ու callback-ով կարգավիճակների ստացումը։
Կիրառություններ
SMS API ինտեգրումն առավել հաճախ կիրառվում է հետևյալ դեպքերում․
- SMS-ով որոշակի բջջային համարին կապված օգտատիրոջ գրանցման հաստատում
- Բանկային հաշվի գործարքների ծանուցումներ
- Պատվերի կարգավիճակի, ակցիաների, նոր ապրանքների և ցանկացած SMS գովազդի ուղարկում
Ինչպես սկսել
Մուտք գործել
Համալրել մնացորդը
Ակտիվացնել API ծառայությունը
Ուղարկել հաղորդագրություն
Ուղարկել հաղորդագրություն
Պարտադիր պարամետրեր
| Պարամետր | Նկարագրություն |
|---|---|
key |
Համակարգին միանալու գաղտնի API բանալի։ Այն կարող եք դիտել և կառավարել ընկերության կարգավորումներում։ |
brandID |
Ուղարկողի ապրանքանիշի եզակի ID-ն համակարգում։ |
numbers |
Ստորակետերով բաժանված բջջային համարներ։ Համարները պետք է լինեն միջազգային ձևաչափով՝ առանց 00 և +. |
text |
Հաղորդագրության տեքստ։ Թույլատրվում են Unicode-ի բոլոր նիշերը։ |
Ընտրովի պարամետրեր
| Պարամետր | Նկարագրություն |
|---|---|
stopList |
stopList=false — անջատում է արգելափակման ցանկի ստուգումը։ Հաղորդագրությունը կուղարկվի նույնիսկ եթե ստացողի համարը այդ ցանկում է։ |
otp |
otp=true — SMS՝ մեկանգամյա մուտքի կոդերի համար (OTP / հաստատման կոդ)։ Ուղարկվում է ամենաբարձր առաջնահերթությամբ։ Օգտագործեք միայն նույնականացման ընթացքում։ Այլ տեսակի հաղորդագրությունների համար կիրառել չի թույլատրվում։ |
sendTime |
Պլանավորված ուղարկման ժամանակը։ Ձևաչափը՝ Y-m-d H:i (օրինակ՝ 2026-02-01 23:30) Նշված ժամանակը պետք է ընթացիկ պահից ավելի ուշ լինի։ Եթե պարամետրը նշված չէ, հաղորդագրությունն ուղարկվում է անմիջապես։ |
callbackUrl |
Այս SMS հարցման անհատական callback URL-ը։ Աշխատում է միայն, եթե API հավելվածի կարգավորումներում ընդհանուր լռելյայն callback URL է նշված։ |
Ավտոմատ ստացեք հաղորդագրությունների կարգավիճակները (Callback)
SMS API-ն թույլ է տալիս ձեր սերվերում ավտոմատ ստանալ ուղարկված հաղորդագրությունների առաքման կարգավիճակները՝ կիրառելով Հետադարձ կանչ մեխանիզմը։
Երբ հաղորդագրության կարգավիճակը փոխվում է (ուղարկված, առաքված, ձախողված և այլն), համակարգը ուղարկում է GET հարցում՝ ձեր նշած HTTPS վերջնակետին։
Callback URL-ի պահանջներ
- URL-ը պետք է սկսվի հետևյալով՝ https://
- Մեթոդը՝ GET
- Callback URL-ը նշվում է ընկերության կարգավորումներում
GET հարցման օրինակ
Վերադարձվող պարամետրեր
| Պարամետր | Նկարագրություն |
|---|---|
key |
Ձեր սերվերի callback ստուգման բանալին։ |
smsID |
Հաղորդագրության եզակի նույնացուցիչը։ |
number |
Ստացողի բջջային համարը՝ միջազգային ձևաչափով։ |
statusID |
Հաղորդագրության ընթացիկ կարգավիճակի կոդը։ |
date |
Կարգավիճակի թարմացման ժամանակը ( Y-m-d H:i:s). |
Կարգավիճակների նշանակությունը
| statusID | Նկարագրություն |
|---|---|
0 |
Ուղարկված |
1 |
Առաքված |
2 |
Ձախողված |
3 |
Սպասման մեջ |
4 |
Սխալ |
Callback մշակման օրինակ (PHP)
<?php
$key = $_GET['key'] ?? null;
$smsID = $_GET['smsID'] ?? null;
$number = $_GET['number'] ?? null;
$statusID = $_GET['statusID'] ?? null;
$date = $_GET['date'] ?? null;
// Validation: make sure key matches your callback key
if ($key !== 'YourCallbackKey') {
http_response_code(403);
echo 'Forbidden';
exit;
}
// Process the received status in your system here
http_response_code(200);
echo 'OK';
?>Callback-ը հաջող է համարվում, եթե ձեր սերվերը վերադարձնում է HTTP 200–299 կարգավիճակի կոդ։
Պատրա՞ստ եք ինտեգրմանը
SMS API-ով արագ ուղարկեք հաղորդագրություններ ձեր համակարգից, կառավարեք առաքման կարգավիճակներն ու ավտոմատացրեք օգտատերերի հետ կապը։
