Документація·Швидкий старт
🚀

Швидкий старт

Перша SMS-верифікація за 90 секунд — реєстрація, ключ API, отримання коду.

Вступ

Eveses надає номери телефонів на вимогу для SMS-верифікацій. Ви замовляєте номер, отримуєте на нього одноразовий код і платите лише тоді, коли SMS реально приходить.

Ця сторінка проведе вас через перший запит end-to-end за три кроки.

1. Створіть API-ключ

Увійдіть і відкрийте Account → API Keys. Натисніть New key, дайте ім'я (наприклад, local-dev) і скопіюйте значення з діалогу. Токен показується лише раз — одразу збережіть його в менеджері паролів або у файлі .env.

export EVESES_API_KEY="17|aBcDeFgHiJ…"

2. Замовте номер

Виберіть країну (ISO-2) та слаг сервісу (telegram, whatsapp, discord, any, …) і зробіть POST на /v1/activations:

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "ua", "service": "telegram", "duration_minutes": 5}'

У відповіді буде номер та id активації, через який ви будете забирати код:

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"waiting","price_cents":50,"expires_at":"2026-05-26T14:35:00Z"}

3. Отримайте код із SMS

Введіть номер у формі верифікації стороннього сервісу, потім опитуйте активацію поки не прийде SMS:

curl https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer $EVESES_API_KEY"

Коли SMS прийде, відповідь міститиме масив sms з OTP. Більшість провайдерів доставляють SMS протягом 30 секунд. Якщо нічого не приходить до дедлайну активації — оплати немає.

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"sms_received","price_cents":50,"expires_at":"2026-05-26T14:35:00Z","sms":[{"code":"123456","text":"Your code: 123456","received_at":"2026-05-26T14:30:14Z"}]}

Що далі

  • Не опитуйте, використовуйте вебхуки — підпишіться на activation.sms_received, і ми самі надішлемо OTP. Дивіться розділ Webhooks.
  • Використовуйте SDK — офіційні бібліотеки для PHP, JavaScript, Python і Go описані в SDKs.
  • Прочитайте про ідемпотентність — обгорніть створення в Idempotency-Key, щоб ретрай не подвоював списання.
Наступна →Активації