Documentation·Démarrage rapide
🚀

Démarrage rapide

Votre première vérification SMS en moins de 90 secondes — inscription, clé API, récupération du code.

Introduction

Eveses fournit des numéros de téléphone à la demande pour les vérifications par SMS. Vous commandez un numéro, récupérez le code à usage unique, et vous ne payez que si le SMS arrive réellement.

Cette page vous guide à travers votre première requête end-to-end en trois étapes.

1. Créer une clé API

Connectez-vous et ouvrez Account → API Keys. Cliquez sur New key, donnez-lui un nom (par exemple local-dev) et copiez la valeur affichée dans la boîte de dialogue. Le jeton n'est révélé qu'une seule fois — rangez-le immédiatement dans votre gestionnaire de mots de passe ou dans un fichier .env.

export EVESES_API_KEY="17|aBcDeFgHiJ…"

2. Commander un numéro

Choisissez un pays (ISO-2) et un slug de service (telegram, whatsapp, discord, any, …) et envoyez un POST sur /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}'

La réponse contient le numéro et un id d'activation avec lequel vous récupérerez le code :

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

3. Lire le code du SMS

Saisissez le numéro dans le formulaire de vérification du service tiers, puis interrogez l'activation jusqu'à l'arrivée du SMS :

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

Lorsque le SMS arrive, la réponse contient un tableau sms avec l'OTP. La plupart des fournisseurs livrent en 30 secondes. Si rien n'arrive avant l'expiration, vous n'êtes pas facturé.

{"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"}]}

Étapes suivantes

  • Arrêtez le polling, utilisez les webhooks — abonnez-vous à activation.sms_received et nous vous enverrons l'OTP. Voir la section Webhooks.
  • Utilisez un SDK — les bibliothèques officielles pour PHP, JavaScript, Python et Go sont documentées dans SDKs.
  • Lisez sur l'idempotence — encapsulez l'appel de création dans une Idempotency-Key pour que les retries ne facturent pas deux fois.
Suivant →Activations