К содержанию
ДокументацияВойти

Быстрый старт

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. HTTP-код 200 означает лишь то, что проверка выполнена: при неверном коде ответ тоже будет 200, а status — pending.

Что дальше