API REST

Numéros, SMS & appels en quelques lignes

Une API REST simple et prévisible : achetez un numéro, envoyez ou recevez un SMS, lancez un appel — le tout par de simples requêtes HTTP authentifiées par clé API.

Obtenir une clé API Documentation complète

REST · JSONWebhooksFacturation à l'usage

quickstart.sh

# 1. Acheter un numéro (+33)
curl -X POST https://esimvoip.com/v1/numbers \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"FR","type":"mobile"}'

# 2. Envoyer un SMS depuis ce numéro
curl -X POST https://esimvoip.com/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number_id":19,"to":"+33612345678","body":"Bonjour !"}'

# ✓ { "id": 31, "status": "sent", "price": 0.15 }

Endpoints

Une API claire et prévisible

Quatre ressources pour tout piloter : numéros, SMS, appels et solde.

GET/v1/numbers/availableChercher des numéros disponibles

POST/v1/numbersAcheter un numéro

GET/v1/numbersLister vos numéros

DELETE/v1/numbers/{id}Libérer un numéro

POST/v1/numbers/{id}/webhooksRecevoir vos SMS/appels en temps réel

POST/v1/messagesEnvoyer un SMS

GET/v1/messagesLister les SMS envoyés & reçus

POST/v1/callsLancer un appel (voix de synthèse)

GET/v1/callsHistorique des appels sortants & entrants

GET/v1/balanceConsulter le solde du portefeuille

Voir la référence complète (paramètres, réponses, erreurs)

Webhooks

Réagissez en temps réel

Configurez une URL par numéro (POST /v1/numbers/{id}/webhooks) : chaque événement vous est notifié par une requête HTTP POST, signée.

EVENTmessage.receivedUn SMS entrant est arrivé sur votre numéro

EVENTcall.ringingVotre numéro reçoit un appel

EVENTcall.completedUn appel entrant s'est terminé (durée, statut)

Authentification & erreurs

Simple à intégrer, simple à déboguer

Clé API

En-tête Authorization: Bearer ev_live_... sur chaque requête. Générez et révoquez vos clés depuis /panel/cles-api.

Erreurs

Toujours au format {"error":{"code":"...","message":"..."}}, avec le code HTTP adapté (401, 402, 404, 422…).

FAQ

Questions fréquentes

Comment m'authentifier ?

Chaque requête utilise votre clé API secrète via l'en-tête Authorization: Bearer ev_live_.... Générez-la depuis /panel/cles-api — elle n'est affichée qu'une seule fois.

Comment recevoir mes SMS et appels entrants en temps réel ?

Configurez une URL de webhook par numéro avec POST /v1/numbers/{id}/webhooks. Vous recevrez un événement JSON signé à chaque SMS ou appel entrant — voir la section Webhooks ci-dessus.

Comment est facturée l'API ?

Aux mêmes tarifs que le panel (numéro mensuel, SMS au segment, appel à la minute), débités directement sur le portefeuille de votre compte. Voir /tarifs.

Commencez à construire dès maintenant

Créez un compte, générez votre clé API et faites votre premier appel en minutes.

Créer un compte gratuit Documentation complète