Aller au contenu
tomnumber

API de vérification SMS

Achetez des numéros et lisez les codes depuis votre propre logiciel. L'API utilise votre solde, les mêmes prix et la même règle de remboursement à 20 minutes que le site.

Vous créez la clé API dans votre compte. Les numéros achetés via l'API sont payés avec le même solde, aux mêmes prix que sur le site.

Créer un compteClé API

Dès $0.0018 par numéro

L'essentiel

Prix le plus bas par numéro
$0.0018
Authentification
Clé API
Format
JSON via HTTPS
Limite de requêtes
120 requêtes par minute
Remboursement
Identique au site

REST et JSON

Six requêtes couvrent le solde, les services, les prix, l'obtention d'un numéro, le statut et l'annulation.

Une clé depuis votre compte

Créez une clé sur la page Clé API de votre compte et envoyez-la dans l'en-tête Authorization.

Mêmes prix que sur le site

Les prix des numéros et la règle de remboursement après 20 minutes sont les mêmes que sur le site.

Quelles requêtes puis-je envoyer ?

Les chemins s'ajoutent après l'URL de base. Chaque requête doit contenir votre clé API.

Quelles requêtes puis-je envoyer ?
Méthode et cheminCe qu'elle fait
GET/balanceVotre solde en USD
GET/servicesTous les services avec le prix le plus bas et le nombre de pays
GET/prices?service=telegramLe prix d'un numéro dans chaque pays pour un service
POST/numbersObtenir un numéro pour un service et un pays ; le prix est prélevé sur votre solde
GET/numbers/{id}Statut d'un numéro et tous les codes reçus jusqu'ici
POST/numbers/{id}/cancelAnnuler avant l'arrivée d'un code ; le prix revient sur votre solde

Dans quel ordre appeler l'API ?

  1. 1

    Obtenir un numéro POST /numbers avec service et country. Enregistrez l'id et le numéro.

  2. 2

    Saisir le numéro Saisissez le numéro dans le service qui envoie le code.

  3. 3

    Vérifier l'arrivée du code GET /numbers/{id} toutes les 5 secondes jusqu'à ce que la liste codes ne soit plus vide.

  4. 4

    Terminer Utilisez le code. Si vous n'avez plus besoin du numéro avant l'arrivée d'un code, annulez-le.

Comment obtenir une clé API ?

Connectez-vous et ouvrez Clé API dans votre compte. Créez une clé et copiez-la tout de suite ; elle ne s'affiche qu'une fois. Créer une nouvelle clé désactive l'ancienne.

Clé API

Quelle est l'URL de base ?

Envoyez chaque requête à cette adresse, avec la clé dans l'en-tête Authorization (Bearer) ou dans l'en-tête X-Api-Key :

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Champs de la requête

Champs de la requête
ChampUtilisé dansValeur
servicePOST /numbers, GET /pricesNom du service tiré de /services, ex. telegram
countryPOST /numbersCode pays à deux lettres, ex. gb

Champs de la réponse et statuts

Champs de la réponse et statuts
ValeurSignification
waitingLe numéro est ouvert et aucun code n'est encore arrivé
receivedAu moins un code est arrivé ; d'autres peuvent encore arriver jusqu'à expires_at
refundedAucun code en 20 minutes ; le prix est revenu sur votre solde
canceledVous avez annulé avant l'arrivée d'un code ; le prix est revenu sur votre solde

Exemple de réponse

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Codes d'erreur

Codes d'erreur
unauthorizedClé API absente ou incorrecte
rate_limitedPlus de 120 requêtes en une minute
bad_serviceNom de service inconnu
bad_countryPays non disponible pour ce service
low_balanceSolde inférieur au prix
unavailableAucun numéro disponible pour le moment. Rien n'a été débité
not_foundAucun numéro avec cet id sur votre compte
cannot_cancelUn code est déjà arrivé ou le numéro est fermé

Exemples de code

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

FAQ de l'API de vérification SMS

Qu'est-ce qu'une API de vérification SMS ?

Un moyen d'acheter des numéros et de lire les codes depuis votre propre programme plutôt que sur le site.

L'API coûte-t-elle plus cher ?

Non. Les numéros coûtent le même prix que sur le site et sont payés avec le même solde.

Combien de requêtes puis-je envoyer ?

Jusqu'à 120 requêtes par minute et par clé. Interroger l'API toutes les 5 secondes reste largement en dessous.

Les numéros obtenus via l'API sont-ils aussi remboursés ?

Oui, avec la même règle : sans code dans les 20 minutes, le prix revient sur votre solde.

Où créer la clé ?

Dans votre compte, sous Clé API.

Numéros virtuels pour d'autres services