Мазмұнға өту
ҚұжаттамаКіру

Жылдам бастау

VERYO Қазақстанның ұялы нөмірлерін растайды. Сіз бір сұрау жібересіз, ал код жұмыс істеп тұрған ең арзан арна арқылы кетеді: Telegram, содан кейін WhatsApp, содан кейін SMS. Төлем — тек кодты жеткізген арна үшін.

API мекенжайы: https://api.veryo.kz. Сұраулар мен жауаптар — JSON.

1. Кілт алыңыз

Кабинетте тіркеліп, API кілттері бөлімінде кілт шығарыңыз. Кілт бір рет көрсетіледі.

Кілт Authorization: Bearer <кілт> тақырыбында беріледі. Оны серверде сақтаңыз және API-ді тек сол жерден шақырыңыз: кілтті мобильді қосымшаға немесе браузерге ендірмеңіз.

2. Кодты сұраңыз

curl -X POST https://api.veryo.kz/v1/verify \
  -H "Authorization: Bearer $VERYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+77011234567", "purpose": "login"}'

201 жауабы:

{"id": "vrf_8c1f04a2b7d93e6f5a10", "status": "pending", "expires_at": "2026-11-08T10:05:00Z"}

id мәнін сақтаңыз — ол тексеру үшін керек болады. Кодты пайдаланушы алады, API жауабында ол жоқ.

3. Кодты тексеріңіз

curl -X POST https://api.veryo.kz/v1/verify/check \
  -H "Authorization: Bearer $VERYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "vrf_8c1f04a2b7d93e6f5a10", "code": "1234"}'

200 жауабы:

{"id": "vrf_8c1f04a2b7d93e6f5a10", "status": "verified", "channel": "telegram"}

Нөмір status мәні verified болғанда ғана расталған болып саналады. 200 HTTP коды тек тексеру орындалғанын білдіреді: код қате болса да жауап 200 болады, ал status — pending.

Әрі қарай