API орқали SMS билан OTP-кодни қандай юбориш: шаблон, сўров ва статуслар

OTP — кириш, рўйхатдан ўтиш ёки тўловни тасдиқлаш учун бир марталик код. У келишилган шаблон бўйича сервис SMS сифатида юборилади. Қуйида — шаблондан биринчи кодгача бўлган йўл.

1. Ўзгарувчили шаблон яратинг

«Шаблонлар» бўлимида код ўрнига ўзгарувчи қўйилган матн қўшинг, масалан:

«Тасдиқлаш кодингиз: {code}. Уни ҳеч кимга айтманг. Компания номи».

Сервис шаблон иш вақтида 30 дақиқагача келишилади. Батафсил — Шаблон яратиш ва модерациядан ўтиш мақоласида.

2. Интеграция калитини олинг

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

Тест калити дарҳол мавжуд: у билан юбориш пулни ечмайди ва операторга кетмайди. Жанговар калит аккаунт тасдиқлангандан кейин берилади.

Батафсил — API: калитлар ва биринчи сўров мақоласида.

3. Сўров юборинг

POST https://usms.uz/api/v1/send манзилига, `Authorization: Bearer LOGIN:SECRET` сарлавҳаси ва JSON форматидаги тана билан сўров юборинг:

• `phone` — қабул қилувчи рақами халқаро форматда, масалан `998901234567`;
• `from` — жўнатувчи номи;
• `template_id` — шаблонингиз рақами;
• `params` — ўзгарувчилар қийматлари, масалан `{"code": "4821"}`.

Жавобда хабар ID’си ва унинг статуси келади.

4. Етказилишни текширинг

Статусни `GET /status/{id}` усули билан сўраш ёки `POST /webhook` орқали ўз манзилингизга билдиришнома олиш мумкин.

Статус маънолари — Хабар статуслари ва пулни қайтариш мақоласида.

OTP учун маслаҳатлар

• Код узоқ яшамаслиги керак: амал қилиш муддатини ўз томонингизда чекланг.
• Битта SMS’да код ва сервис номидан бошқа ортиқча маълумот юборманг.
• Сайтлар учун тайёр рақамни тасдиқлаш виджети мавжуд — USMS интеграциялари саҳифасида.
• Тўлиқ ҳужжатлар тўққиз тилда: api.usms.uz.