- Startseite
- API
API für SMS-Verifizierung
Kaufen Sie Nummern und lesen Sie Codes aus Ihrer eigenen Software. Die API nutzt Ihr Guthaben, dieselben Preise und dieselbe 20-Minuten-Erstattungsregel wie die Website.
Den API-Schlüssel erstellen Sie in Ihrem Konto. Über die API gekaufte Nummern werden vom selben Guthaben zu denselben Preisen wie auf der Website abgebucht.
Die wichtigsten Fakten
- Niedrigster Preis pro Nummer
- $0.0018
- Authentifizierung
- API-Schlüssel
- Format
- JSON über HTTPS
- Ratenlimit
- 120 Anfragen pro Minute
- Rückerstattung
- Wie auf der Website
REST und JSON
Sechs Anfragen decken Guthaben, Dienste, Preise, Nummernabruf, Status und Stornierung ab.
Ein Schlüssel aus Ihrem Konto
Erstellen Sie einen Schlüssel auf der Seite API-Schlüssel in Ihrem Konto und senden Sie ihn im Authorization-Header.
Dieselben Preise wie auf der Website
Nummernpreise und die 20-Minuten-Erstattungsregel sind dieselben wie auf der Website.
Welche Anfragen kann ich senden?
Die Pfade folgen auf die Basis-URL. Jede Anfrage braucht Ihren API-Schlüssel.
| Methode und Pfad | Funktion |
|---|---|
GET/ | Ihr Guthaben in USD |
GET/ | Alle Dienste mit niedrigstem Preis und Anzahl der Länder |
GET/ | Preis einer Nummer in jedem Land für einen Dienst |
POST/ | Nummer für einen Dienst und ein Land holen, der Preis wird vom Guthaben abgezogen |
GET/ | Status einer Nummer und alle bisher empfangenen Codes |
POST/ | Vor dem Eintreffen eines Codes stornieren, der Preis geht zurück auf Ihr Guthaben |
In welcher Reihenfolge rufe ich die API auf?
- 1
Nummer holen POST /numbers mit service und country. Speichern Sie id und number.
- 2
Nummer eingeben Geben Sie die Nummer bei dem Dienst ein, der den Code sendet.
- 3
Code abfragen GET /numbers/{id} alle 5 Sekunden, bis die Liste codes nicht mehr leer ist.
- 4
Abschließen Verwenden Sie den Code. Brauchen Sie die Nummer nicht mehr, bevor ein Code kommt, stornieren Sie sie.
Wie bekomme ich einen API-Schlüssel?
Melden Sie sich an und öffnen Sie in Ihrem Konto „API-Schlüssel“. Erstellen Sie einen Schlüssel und kopieren Sie ihn sofort. Er wird nur einmal angezeigt. Ein neuer Schlüssel deaktiviert den alten.
API-SchlüsselWie lautet die Basis-URL?
Senden Sie jede Anfrage an diese Adresse, mit dem Schlüssel im Authorization-Header (Bearer) oder im X-Api-Key-Header:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>Anfragefelder
| Feld | Verwendet in | Wert |
|---|---|---|
service | POST /numbers, GET /prices | Dienstname aus /services, z. B. telegram |
country | POST /numbers | Zweistelliger Ländercode, z. B. gb |
Antwortfelder und Status
| Wert | Bedeutung |
|---|---|
waiting | Nummer ist offen, noch kein Code eingetroffen |
received | Mindestens ein Code ist eingetroffen, bis expires_at können weitere kommen |
refunded | Kein Code innerhalb von 20 Minuten, der Preis ging zurück auf Ihr Guthaben |
canceled | Sie haben storniert, bevor ein Code kam, der Preis ging zurück auf Ihr Guthaben |
Beispielantwort
{ "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" } ]}Fehlercodes
unauthorized | API-Schlüssel fehlt oder ist falsch |
rate_limited | Mehr als 120 Anfragen in einer Minute |
bad_service | Unbekannter Dienstname |
bad_country | Land für diesen Dienst nicht verfügbar |
low_balance | Guthaben ist niedriger als der Preis |
unavailable | Gerade ist keine Nummer verfügbar. Es wurde nichts abgebucht |
not_found | Keine Nummer mit dieser id in Ihrem Konto |
cannot_cancel | Ein Code ist bereits eingetroffen oder die Nummer ist geschlossen |
Codebeispiele
# 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 zur API für SMS-Verifizierung
Was ist eine API für SMS-Verifizierung?
Eine Möglichkeit, Nummern zu kaufen und Codes aus Ihrem eigenen Programm statt über die Website abzurufen.
Kostet die API extra?
Nein. Nummern kosten dasselbe wie auf der Website und werden aus demselben Guthaben bezahlt.
Wie viele Anfragen kann ich senden?
Bis zu 120 Anfragen pro Minute und Schlüssel. Eine Abfrage alle 5 Sekunden liegt deutlich darunter.
Werden API-Nummern auch erstattet?
Ja, nach derselben Regel: Kommt innerhalb von 20 Minuten kein Code, geht der Preis zurück auf Ihr Guthaben.
Wo erstelle ich den Schlüssel?
In Ihrem Konto unter API-Schlüssel.