- Accueil
- API
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.
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.
| Méthode et chemin | Ce qu'elle fait |
|---|---|
GET/ | Votre solde en USD |
GET/ | Tous les services avec le prix le plus bas et le nombre de pays |
GET/ | Le prix d'un numéro dans chaque pays pour un service |
POST/ | Obtenir un numéro pour un service et un pays ; le prix est prélevé sur votre solde |
GET/ | Statut d'un numéro et tous les codes reçus jusqu'ici |
POST/ | Annuler avant l'arrivée d'un code ; le prix revient sur votre solde |
Dans quel ordre appeler l'API ?
- 1
Obtenir un numéro POST /numbers avec service et country. Enregistrez l'id et le numéro.
- 2
Saisir le numéro Saisissez le numéro dans le service qui envoie le code.
- 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
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é APIQuelle 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/v1Authorization: Bearer <API_KEY>Champs de la requête
| Champ | Utilisé dans | Valeur |
|---|---|---|
service | POST /numbers, GET /prices | Nom du service tiré de /services, ex. telegram |
country | POST /numbers | Code pays à deux lettres, ex. gb |
Champs de la réponse et statuts
| Valeur | Signification |
|---|---|
waiting | Le numéro est ouvert et aucun code n'est encore arrivé |
received | Au moins un code est arrivé ; d'autres peuvent encore arriver jusqu'à expires_at |
refunded | Aucun code en 20 minutes ; le prix est revenu sur votre solde |
canceled | Vous 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
unauthorized | Clé API absente ou incorrecte |
rate_limited | Plus de 120 requêtes en une minute |
bad_service | Nom de service inconnu |
bad_country | Pays non disponible pour ce service |
low_balance | Solde inférieur au prix |
unavailable | Aucun numéro disponible pour le moment. Rien n'a été débité |
not_found | Aucun numéro avec cet id sur votre compte |
cannot_cancel | Un 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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])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.