API orqali SMS bilan OTP-kodni qanday yuborish: shablon, so‘rov va statuslar

OTP — kirish, ro‘yxatdan o‘tish yoki to‘lovni tasdiqlash uchun bir martalik kod. U kelishilgan shablon bo‘yicha servis SMS sifatida yuboriladi. Quyida — shablondan birinchi kodgacha bo‘lgan yo‘l.

1. O‘zgaruvchili shablon yarating

«Shablonlar» bo‘limida kod o‘rniga o‘zgaruvchi qo‘yilgan matn qo‘shing, masalan: «Tasdiqlash kodingiz: {code}. Uni hech kimga aytmang. Kompaniya nomi». Servis shablon ish vaqtida 30 daqiqagacha kelishiladi (Shablon yaratish va moderatsiyadan o‘tish maqolasiga qarang).

2. Integratsiya kalitini oling

Profil → «Integratsiya uchun kirish». Test kaliti darhol mavjud: u bilan yuborish pulni yechmaydi va operatorga ketmaydi. Jangovar kalit akkaunt tasdiqlangandan keyin beriladi. Batafsil — API: kalitlar va birinchi so‘rov maqolasida.

3. So‘rov yuboring

POST https://usms.uz/api/v1/send, Authorization: Bearer LOGIN:SECRET sarlavhasi va JSON formatidagi tana bilan:

• phone — qabul qiluvchi raqami xalqaro formatda, masalan 998901234567;
• from — jo‘natuvchi nomi;
• template_id — shabloningiz raqami;
• params — o‘zgaruvchilar qiymatlari, masalan {"code": "4821"}.

Javobda xabar id’si va uning statusi keladi.

4. Yetkazilishni tekshiring

Statusni GET /status/{id} usuli bilan so‘rash yoki POST /webhook orqali o‘z manzilingizga bildirishnoma olish mumkin. Status ma’nolari — Xabar statuslari va pulni qaytarish maqolasida.

OTP uchun maslahatlar

• Kod uzoq yashamaydi: amal qilish muddatini o‘z tomoningizda cheklang.
• Bitta SMS’da koddan va servis nomidan boshqa narsa yubormang.
• Saytlar uchun tayyor raqamni tasdiqlash vidjeti bor — USMS integratsiyalari sahifasiga qarang.
• To‘liq hujjatlar to‘qqiz tilda: api.usms.uz.