API: калитлар ва биринчи сўров

API орқали SMS’ни тўғридан-тўғри ўз тизимингиздан — сайт, CRM, иловадан юбориш мумкин. Тўққиз тилдаги мисоллар билан тўлиқ ҳужжатлар: api.usms.uz.

Калитни қаердан олиш мумкин

Профил → «Профил» → «Интеграция учун кириш» блоки.

• Тест калити аккаунт тасдиқланмасдан дарҳол мавжуд. У бўйича юбориш пул ечмайди ва операторга бормайди — интеграцияни текшириш учун қулай.
• Жанговар калит аккаунт тасдиқлангандан кейин берилади: «Калит яратиш».

Калит — логин ва махфий калит жуфтлиги. Махфий калитни «Кўрсатиш» тугмаси билан қайта кўриш мумкин. Қайта чиқарилганда эски калит дарҳол ишламай қолади.

Қандай авторизация қилиш керак

Ҳар бир сўровда сарлавҳани юборинг:

Authorization: Bearer LOGIN:SECRET

Бу кабинет пароли эмас — фақат «Интеграция учун кириш» блокидаги жуфтлик.

Асосий методлар

Асосий манзил: https://usms.uz/api/v1

• GET /balance — баланс;
• GET /templates — шаблонларингиз;
• POST /send — битта хабар;
• POST /send-batch — хабарлар тўплами;
• GET /status/{id} — хабар ҳолати;
• POST /quote — юборишдан олдин нархни ҳисоблаш;
• GET /messages — юборилганлар рўйхати;
• POST /templates/request — янги шаблонга ариза;
• POST /webhook — ҳолатлар ҳақида билдиришномалар манзили.

Махфий калитни ҳеч кимга юборманг — на чатларда, на қўллаб-қувватлашга мурожаатларда. Агар калит бегона қўлга тушса, уни дарҳол қайта чиқаринг.