Документация·Быстрый старт
🚀

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

Первая 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, чтобы ретрай не задваивал списание.
Следующая →Активации