Tschechische SMS-OTP-Codes über Endpunkte, Webhooks oder das Dashboard empfangen

Welche Endpunkte nutzt die Tschechien-OTP-API?

Alles läuft gegen https://otproute.com/api/v1 mit einem Bearer-Schlüssel mit dem Präfix or_live_. Schlüssel erstellen Sie in der Developer-Konsole; ein Konto kann bis zu 10 davon halten. So lassen sich Staging, CI und ein lokaler Laptop mit getrennten Zugangsdaten ausstatten, die sich einzeln widerrufen lassen. Das Ratenlimit beträgt 300 Anfragen pro Minute und Konto.

Ein typischer +420-Durchlauf sieht so aus:

1. Rufen Sie GET /api/v1/countries und GET /api/v1/services einmal pro Deployment ab und cachen Sie die Antworten. Die tschechische Länder-ID lautet cz.
2. Fragen Sie mit GET /api/v1/prices?country=cz&service=<id> den aktuellen Preis der geplanten Route ab; er ändert sich mit dem Dienst und dem Bestand.
3. Legen Sie die Aktivierung mit POST /api/v1/activations und dem JSON-Body {"service": "<id>", "country": "cz"} an. Die Antwort liefert eine Aktivierungs-ID und die Nummer, die Sie in das zu testende Registrierungsformular eintragen.
4. Warten Sie auf den Code, entweder per Webhook oder durch Abfragen von GET /api/v1/activations/{id} in moderaten Abständen.
5. Wird der Test abgebrochen, geben Sie die Nummer mit POST /api/v1/activations/{id}/cancel frei, damit die Reservierung sofort ins Guthaben zurückfließt.

Ein Aufruf von GET /api/v1/balance vor einer großen Testsuite ist ein günstiger Weg, bei knappem Guthaben schnell abzubrechen. Die vollständige Referenz finden Sie in den Docs.

Wie verifiziere ich Webhooks für +420-Aktivierungen?

Webhooks ersparen das Polling und eignen sich für parallele Test-Runner. Richten Sie einen Ihrer Endpunkte (die Developer-Konsole erlaubt 5 pro Konto) auf den tschechischen Ablauf und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled.

Jede Anfrage enthält einen X-OTPRoute-Signature-Header in der Form t=<unix>,v1=<hex>. Bilden Sie aus den unveränderten Request-Bytes den String <t>.<raw body>, berechnen Sie HMAC-SHA256 mit dem Secret des jeweiligen Endpunkts, vergleichen Sie das Ergebnis in konstanter Zeit mit v1 und verwerfen Sie alles, dessen Zeitstempel zu alt für eine frische Zustellung ist. Unser Leitfaden zum Absichern von OTP-Webhooks mit HMAC geht einen Handler Zeile für Zeile durch.

Behandeln Sie Ereignisse als an die Aktivierungs-ID gebunden und machen Sie den Handler idempotent: Eine wiederholte Zustellung sollte die Aktivierung bereits als abgeschlossen vorfinden und einfach Erfolg zurückmelden. Das Abfragen von GET /api/v1/activations/{id} bleibt ein gültiger Ersatz für Skripte, die dort laufen, wo kein öffentlicher Endpunkt existiert.

Welche Dienste können Codes an tschechische Nummern senden?

Die tschechische Route deckt derzeit mehr als 1.700 Dienste ab. Zu den beliebten Namen im aktuellen Stand gehören WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Microsoft & Outlook, LinkedIn, Discord, Uber, Airbnb, Signal, Viber und ChatGPT (OpenAI).

Diese Liste ist nicht in Stein gemeißelt. Der Bestand verändert sich im Tagesverlauf, deshalb sollte Code die Verfügbarkeit zur Laufzeit aus der API lesen statt aus einer fest einprogrammierten Tabelle. Fehlt ein benötigter Dienst zu einem Zeitpunkt, taucht er vielleicht später wieder auf, oder eine benachbarte mitteleuropäische Route passt für den Testfall.

Wie sollte eine tschechische Verifizierungsnummer gespeichert und geparst werden?

Die tschechische Nummerierung ist geschlossen: Nationale Nummern haben neun Ziffern und kein Vorwahl-Präfix, sodass sich die Inlands- und die internationale Form nur durch das vorangestellte +420 unterscheiden. Das macht die Normalisierung einfacher als in vielen anderen Märkten, doch Formulare erhalten trotzdem Leerzeichen, das internationale Präfix 00420 oder bloße neun Ziffern. Entfernen Sie Trennzeichen, wandeln Sie 00 in + um, ergänzen Sie +420, wenn es fehlt, und speichern Sie das Ergebnis im E.164-Format.

Codes tschechischer Apps kommen meist auf Tschechisch oder Englisch an. Tschechische Texte enthalten Diakritika wie Háček und Čárka, und manche Absender entfernen sie, um die Nachricht im einfachen Zeichensatz zu halten. Ein Parser sollte daher nach der Ziffernfolge suchen statt einen ganzen Satz abzugleichen.

Teams nutzen eine +420-Nummer zum Testen, wenn sie ein Produkt für tschechische Kunden starten, tschechische Onboarding-Texte prüfen oder bestätigen, dass ein regionaler Registrierungsablauf Nummern ohne führende Null akzeptiert. Die Seite zum Thema QA-Testing skizziert, wie Teams solche Durchläufe aufbauen.

Was soll passieren, wenn ein tschechischer Code nicht ankommt?

Manche Dienste lehnen virtuelle Nummern ab, und manche Routen sind zu bestimmten Zeiten langsamer. Ein verpasster Code kostet nichts: Trifft innerhalb des 20-Minuten-Fensters keine SMS ein oder brechen Sie vorher ab, wird der volle Betrag automatisch dem Guthaben gutgeschrieben.

• Lassen Sie das Zeitfenster ablaufen, bevor Sie den Versuch als gescheitert werten.
• Prüfen Sie, ob der getestete Dienst virtuelle Nummern überhaupt akzeptiert.
• Versuchen Sie es später erneut oder über eine andere Länderroute, die der Dienst unterstützt.
• Halten Sie zwischen den Versuchen Abstand; Neubestellungen in einer engen Schleife verbrauchen Ratenlimit und helfen selten.
• Protokollieren Sie die Aktivierungs-ID bei jedem Fehlschlag, damit sich über mehrere Läufe hinweg Muster zeigen.

Können Nicht-Entwickler die +420-Route im Dashboard nutzen?

Ja. Nach der Registrierung mit E-Mail und einem 6-stelligen E-Mail-Code (oder Google-Anmeldung) öffnen Sie das OTP Gateway, wählen den Dienst und Tschechien, prüfen den angezeigten Preis und bestellen. Die tschechische Verifizierungsnummer erscheint sofort; fügen Sie sie in die App ein, und der Code wird auf demselben Bildschirm angezeigt, sobald er eintrifft. Ein Abbruch im Dashboard erstattet den Betrag genauso wie der API-Aufruf.

Gibt es eine langfristige tschechische Nummer, und wie wird abgerechnet?

Eine langfristige tschechische Nummer im Self-Service gibt es derzeit nicht. Dedicated Numbers sind ein Produkt für die USA und Kanada ab $1.95/month, mit eingehenden und ausgehenden SMS sowie Telefonie im Browser; Details unter virtuelle Nummern. Braucht Ihr Team eine dauerhafte +420-Leitung, schreiben Sie an [email protected] und fragen Sie nach, mit dem Wissen, dass die Verfügbarkeit von den lokalen Vorschriften abhängt und nicht zugesagt wird.

Abgerechnet wird über ein vorausbezahltes USD-Guthaben ohne Monatsgebühr und ohne Tarifwahl. Aufgeladen wird per Karte oder als USDT/USDC, und jede Aufladung löst eine PDF-Rechnung per E-Mail aus. Für die Integrationsarbeit lässt sich auf Anfrage ein Entwicklungskonto auf Sandbox umstellen, sodass simulierte Nummern und Codes den gesamten Ablauf durchspielen, ohne Guthaben zu verbrauchen. Für die Anmeldung am Konto selbst steht eine Zwei-Faktor-Authentifizierung per TOTP zur Verfügung. @faq

Häufige Fragen

Kann ich die tschechische Registrierung meiner App ohne tschechische SIM-Karte testen?

Ja. Bestellen Sie für den zu testenden Dienst eine +420-Nummer im OTP Gateway, tragen Sie sie in Ihre App ein und lesen Sie den Code im Dashboard, über die API oder per Webhook aus.

Wie lautet die Länder-ID für Tschechien in der OTP-Route-API?

Verwenden Sie cz im Feld country von POST /api/v1/activations und bei Preisabfragen.

Was kostet ein tschechischer Verifizierungscode?

Codes beginnen bei $0.20 pro Code; den genauen Preis für jeden Dienst liefert GET /api/v1/prices, und er wird vor der Bestellung angezeigt. Sie zahlen nur, wenn ein Code ankommt.

Brauchen tschechische Nummern eine führende Null?

Nein. Tschechische Nummern haben kein Vorwahl-Präfix, speichern Sie sie also als +420 gefolgt von den neun nationalen Ziffern.

Wie lange bleibt eine +420-Aktivierung offen?

Zwanzig Minuten. Kommt in dieser Zeit nichts an, läuft die Aktivierung ab, und das Guthaben wird vollständig erstattet.

Eignet sich OTP-Routing nach Tschechien für die massenhafte Kontoerstellung?

Nein. OTP Route dient dem Testen Ihres eigenen Produkts und dem Betrieb Ihrer eigenen legitimen Konten. Halten Sie jede +420-Aktivierung an Ihr eigenes Produkt oder Konto gebunden, im Rahmen der Bedingungen des jeweiligen Dienstes und der Acceptable Use Policy von OTP Route.

Kann ich dieselbe tschechische Nummer für spätere Logins behalten?

Nicht als Self-Service-Produkt. Langfristige Dedicated Numbers gibt es nur in den USA und Kanada; nach anderen Märkten können Sie beim Support per E-Mail fragen.

Dienstnamen sind Marken ihrer jeweiligen Inhaber. OTP Route steht in keiner Verbindung zu ihnen. Nutzen Sie die Nummern rechtmäßig und beachten Sie die Bedingungen des jeweiligen Dienstes sowie unsere Richtlinie zur akzeptablen Nutzung.