API: kalitlar va birinchi so‘rov

API orqali SMS’ni to‘g‘ridan-to‘g‘ri o‘z tizimingizdan — sayt, CRM, ilovadan yuborish mumkin. To‘qqiz tildagi misollar bilan to‘liq hujjatlar: api.usms.uz.

Kalitni qayerdan olish mumkin

Profil → «Profil» → «Integratsiya uchun kirish» bloki.

• Test kaliti akkaunt tasdiqlanmasdan darhol mavjud. U bo‘yicha yuborish pul yechmaydi va operatorga bormaydi — integratsiyani tekshirish uchun qulay.
• Jangovar kalit akkaunt tasdiqlangandan keyin beriladi: «Kalit yaratish».

Kalit — login va maxfiy kalit juftligi. Maxfiy kalitni «Ko‘rsatish» tugmasi bilan qayta ko‘rish mumkin. Qayta chiqarilganda eski kalit darhol ishlamay qoladi.

Qanday avtorizatsiya qilish kerak

Har bir so‘rovda sarlavhani yuboring:

Authorization: Bearer LOGIN:SECRET

Bu kabinet paroli emas — faqat «Integratsiya uchun kirish» blokidagi juftlik.

Asosiy metodlar

Asosiy manzil: https://usms.uz/api/v1

• GET /balance — balans;
• GET /templates — shablonlaringiz;
• POST /send — bitta xabar;
• POST /send-batch — xabarlar to‘plami;
• GET /status/{id} — xabar holati;
• POST /quote — yuborishdan oldin narxni hisoblash;
• GET /messages — yuborilganlar ro‘yxati;
• POST /templates/request — yangi shablonga ariza;
• POST /webhook — holatlar haqida bildirishnomalar manzili.

Maxfiy kalitni hech kimga yubormang — na chatlarda, na qo‘llab-quvvatlashga murojaatlarda. Agar kalit begona qo‘lga tushsa, uni darhol qayta chiqaring.