Katar-OTP-API: Webhooks, Polling und +974-Testnummern

Wie sieht die Aufrufabfolge der Katar-OTP-API aus?

Alles liegt unter https://otproute.com/api/v1 und wird mit einem Bearer-Key authentifiziert, der mit or_live_ beginnt. Sie können bis zu 10 Keys halten; geben Sie CI, Staging und dem Operations-Skript getrennte Keys, damit sich einer widerrufen lässt, ohne die anderen anzufassen. Eine vollständige +974-Aktivierung braucht höchstens vier Aufrufe:

1. GET /api/v1/prices?country=qa&service=<id> liefert den aktuellen Preis und zeigt, dass die Route für diesen Dienst gerade offen ist.
2. POST /api/v1/activations mit {"service": "<id>", "country": "qa"} reserviert eine katarische Nummer und gibt eine Aktivierungs-ID zurück.
3. GET /api/v1/activations/{id} ist der Polling-Aufruf: Er zeigt den Stand der Katar-Bestellung und enthält nach der Zustellung den Code.
4. POST /api/v1/activations/{id}/cancel beendet die Bestellung vorzeitig und schreibt den Betrag dem Guthaben gut.

Zwei Helfer runden das Bild ab: GET /api/v1/services ordnet Namen den Dienst-IDs zu, und mit GET /api/v1/balance kann eine Pipeline stoppen, bevor das Guthaben leer ist. Bleiben Sie pro Konto unter 300 Anfragen pro Minute. Die Entwicklerübersicht bündelt die Referenzseiten.

Wie sollte ein Webhook-Handler Katar-Aktivierungsevents behandeln?

Polling funktioniert, aber ein Webhook lässt Ihren Test-Runner im selben Moment reagieren, in dem etwas passiert. Registrieren Sie bis zu fünf Endpunkte und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled; das erste enthält den Code, die beiden anderen sagen Ihrem Runner, dass er nicht mehr warten muss.

Jede Anfrage enthält X-OTPRoute-Signature in der Form t=<unix>,v1=<hex>. Bauen Sie den signierten String aus Zeitstempel, einem Punkt und dem rohen Request-Body nach, berechnen Sie HMAC-SHA256 mit dem Endpunkt-Secret und vergleichen Sie in konstanter Zeit. Lehnen Sie alles mit veraltetem Zeitstempel ab. Da Wiederholungsversuche dasselbe Event mehrfach zustellen können, speichern Sie die Aktivierungs-ID und ignorieren Sie Dubletten. Eine Referenzimplementierung finden Sie in Webhook-basierte OTP-Erfassung.

Welche Dienste können einen Code an eine +974-Nummer zustellen?

Katar gehört zu den breiteren Routen, mit mehr als 1.600 Diensten im aktuellen Stand. Beliebte Einträge sind WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude und Discord.

Der Bestand verschiebt sich im Tagesverlauf; betrachten Sie die Momentaufnahme daher als Orientierung und die Antwort der API als maßgeblich. Einige Dienste lehnen virtuelle Nummern ab; dann läuft die Bestellung einfach ab, und das Geld geht zurück. Jeder oben genannte Name ist eine Marke seines Inhabers; eine Verbindung wird damit nicht behauptet.

Katarische Nummern in Testdaten normalisieren

Katarische Nummern haben nach +974 acht Ziffern und kein Trunk-Präfix, es gibt beim Umwandeln einer lokalen Nummer in die internationale Form also nichts wegzulassen. Halten Sie Testdaten in E.164 (+974 plus acht Ziffern) und bereinigen Sie Eingaben, die Nutzer mit 00974, Leerzeichen oder einer führenden Null aus den Gewohnheiten anderer Länder tippen.

Arabisch ist Amtssprache, während Englisch im Geschäftsleben weit verbreitet ist und von einer Bevölkerung mit großem Anteil an Zugewanderten genutzt wird. Bestätigungs-SMS kommen daher in der Sprache an, die der sendende Dienst für das Konto wählt, oft Englisch oder Arabisch. Prüfen Sie, dass Ihre Extraktionslogik den Code in beiden Schriften findet und dass das OTP-Eingabefeld in einer arabischen Oberfläche mit Rechts-nach-links-Layout bedienbar bleibt.

Teams testen die Katar-Route beim Start im GCC-Raum, bei der Lokalisierung einer Consumer-App für arabischsprachige Nutzer, im Hospitality- oder Logistikbetrieb in Doha oder bei der Verifizierung eines regionalen Geschäftskontos, ohne die private Nummer eines Mitarbeiters zu hinterlegen. Der CI-Testleitfaden zeigt, wie sich diese Prüfungen in automatisierte Läufe einbinden lassen.

Eine Katar-Prüfung stattdessen im Dashboard durchführen

Nicht jede Verifizierung braucht ein Skript. Öffnen Sie im Dashboard das OTP Gateway, wählen Sie Katar und den Dienst, prüfen Sie den angezeigten Preis und bestätigen Sie. Kopieren Sie die +974-Nummer in die App, fordern Sie die SMS an, und der Code erscheint bei der Bestellung. Das 20-Minuten-Fenster läuft ab dem Moment, in dem Sie bestellen, und Sie zahlen nur, wenn ein Code ankommt.

Codes, die nicht ankommen: eine Debugging-Liste

• Lange genug gewartet? Lassen Sie die Aktivierung ihr volles Fenster durchlaufen, bevor Sie sie als fehlgeschlagen werten.
• Virtuelle Nummern akzeptiert? Manche Dienste blockieren sie, und wiederholte Versuche ändern daran nichts.
• Vernünftige Retry-Strategie? Warten Sie und versuchen Sie es später erneut oder wechseln Sie für denselben Dienst auf eine andere Route. Neubestellungen in enger Schleife verbrauchen Ihr Ratenlimit und helfen selten.
• Handler in Ordnung? Schlägt die Signaturprüfung fehl oder gibt der Endpunkt einen Fehler zurück, pollen Sie GET /api/v1/activations/{id}, um zu sehen, ob der Code zugestellt wurde, während Ihr Webhook ihn verpasst hat.

Eine Aktivierung, die ohne SMS endet – durch Ablauf oder Stornierung –, wird vollständig erstattet.

Gibt es eine langfristige katarische Leitung, und wie wird die Nutzung abgerechnet?

Für Katar gibt es keine langfristige Nummer im Self-Service. Dedicated Virtual Numbers (eine eigene Leitung mit eingehenden und ausgehenden SMS, Webhook-Weiterleitung und Telefonie im Browser) werden nur in den USA und Kanada angeboten, ab $1.95/month. Bei einem Katar-spezifischen Bedarf schreiben Sie an [email protected]; was möglich ist, bestimmen die lokalen Vorschriften.

Die Nutzung für Katar läuft über ein vorausbezahltes USD-Guthaben, monatlich wird nichts berechnet. Laden Sie per Karte oder USDT/USDC auf, erhalten Sie zu jeder Aufladung eine PDF-Rechnung und beantragen Sie den Sandbox-Modus für ein Entwicklungskonto, wenn Sie die Integration mit simulierten Nummern und Codes testen möchten. Verwenden Sie +974-Nummern nur für Ihre eigenen Produkte und legitime Geschäftskonten, beachten Sie die Bedingungen des jeweiligen Dienstes und halten Sie sich an die Acceptable Use Policy von OTP Route.

Häufige Fragen

Wie empfange ich Katar-SMS-OTP-Codes in einem automatisierten Test?

Legen Sie eine Aktivierung mit dem Land qa an, geben Sie die zurückgegebene Nummer in der zu testenden App ein und warten Sie auf den Webhook activation.sms_received. OTP Route unterstützt auch das Polling der Aktivierung, falls Ihr Test-Runner keine eingehenden Anfragen annehmen kann.

Kann ich eine +974-Nummer zum Testen ohne katarische SIM nutzen?

Ja. Das OTP Gateway stellt eine Katar-Verifizierungsnummer für einen Code bereit, sodass Sie Registrierungs- oder Login-Abläufe ohne lokale SIM oder ein Gerät testen können.

Wie prüfe ich vor der Bestellung die Preise für Katar?

Rufen Sie GET /api/v1/prices?country=qa&service=<id> auf oder schauen Sie im Dashboard nach. Die Preise beginnen bei $0.20 pro Code und variieren je nach Dienst.

Werden mir fehlgeschlagene Katar-Aktivierungen berechnet?

Nein. Berechnet wird nur, wenn ein Code ankommt; abgelaufene oder stornierte Aktivierungen werden automatisch dem Guthaben gutgeschrieben.

Warum mit einer katarischen Nummer testen statt mit einer aus einem Nachbarland?

Wählen Sie das Land, das zum realen Markt des Kontos passt. Startet Ihr Produkt in Katar, bildet eine +974-Nummer genau die Behandlung der Ländervorwahl, die Sprache und das OTP-Routing ab, die Ihre Kunden erleben werden – siehe Länder-Routing für OTP.

Kann ein Entwicklungskonto ohne Guthaben laufen?

Ja. Auf Anfrage kann ein Entwicklungskonto in den Sandbox-Modus geschaltet werden, der simulierte Nummern und Codes für End-to-End-Tests liefert.

Kann ich eine katarische Nummer für wiederholte Logins behalten?

Nicht im Self-Service, da dedizierte Leitungen auf die USA und Kanada beschränkt sind. Schreiben Sie an [email protected], wenn Sie nach einer langfristigen Katar-Leitung fragen möchten.

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.