📘 Documentation développeur

Recevez votre premier SMS en 90 secondes

API REST, 4 SDK typés, webhooks signés, clés d'idempotence, pools dédiés en Enterprise. Référence complète + code fonctionnel dans votre langage.

Démarrage rapide

Trois appels et c'est terminé

  1. 1
    Achetez un numéro

    Choisissez pays + service. Nous attribuons un vrai numéro de téléphone depuis le pool amont sain le moins cher.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders \
      -H "Authorization: Bearer $KEY" \
      -d '{"country":"ua","mode":"activation","service":"telegram"}'
    
    # → 201 Created · 142ms
    # { "order_id":"ord_91f3a2b8", "phone":"+380635551822", "status":"waiting", "price_cents":7 }
  2. 2
    Attendez le SMS · polling ou webhook

    Soit vous abonnez-vous au webhook activation.sms_received, soit vous interrogez. L'arrivée SMS p95 est de 2,1 secondes.

    curl https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/sms \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 87ms
    # { "status":"sms_received", "sms":[{ "otp":"123456", "received_at":"..." }] }
  3. 3
    Terminez — les fonds sont débités

    Tant que vous n'appelez pas finish, les fonds restent réservés, non dépensés. Annulez à tout moment dans la fenêtre pour un remboursement complet.

    curl -X POST https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/finish \
      -H "Authorization: Bearer $KEY"
    
    # → 200 OK · 61ms
    # { "status":"finished", "charged_cents":7 }

Parcourir la documentation

Recherchable, avec des exemples dans 4 langages, et un sandbox Try-it en direct sur chaque endpoint.

📦 SDK typés

4 langages · tous générés à partir de la même spécification OpenAPI · réessais automatiques · erreurs typées.

JS@eveses/sdkPYEvesesGOevesescom/go-sdkPHPeveses/sdk
RBeveses-rb (soon)
RSeveses-rs (soon)
JVeveses-java (soon)

Prêt à déployer ?

Première activation offerte · sans carte requise · remboursement si pas de SMS.

⚡ S'inscrire — commencer à construire
RESTEZ INFORMÉ

Nouvelles géos, nouveaux pools, nouveaux endpoints.

Nous ajoutons des pays, faisons tourner les pools et publions des changements d'API presque chaque semaine. Laissez votre e-mail et nous vous enverrons l'essentiel : nouvelle couverture géographique, évolutions du barème et tout ce qui casse une intégration.

✓ Nouvelles géos et produits⚡ Changements cassants de l'API🫥 Jamais de spam

Désinscription en un clic. Nous ne partageons jamais votre email.