Einen +592-Verifizierungstest mit Webhooks und Polling aufbauen

Wie entwerfe ich einen Webhook-orientierten Guyana-OTP-API-Ablauf?

Für alles, was über eine einmalige Prüfung hinausgeht, sollten Sie sich Codes von der Plattform zustellen lassen, statt ständig nachzufragen. Fügen Sie in der Developer-Konsole einen HTTPS-Endpunkt hinzu (ein Konto kann 5 halten) und abonnieren Sie dort activation.sms_received sowie activation.expired und activation.cancelled, damit Ihr Test-Runner von Sackgassen genauso schnell erfährt wie von Erfolgen.

Behandeln Sie jede eingehende Anfrage als nicht vertrauenswürdig, bis sie die Prüfung bestanden hat:

• Lesen Sie den Header X-OTPRoute-Signature, der die Form t=<unix>,v1=<hex> hat.
• Verbinden Sie Zeitstempel, einen Punkt und den unveränderten Request-Body und berechnen Sie über diese Zeichenfolge HMAC-SHA256 mit dem Secret des Endpunkts.
• Vergleichen Sie Ihren Digest in konstanter Zeit mit v1 und verwerfen Sie die Anfrage, wenn der Zeitstempel veraltet ist.
• Entnehmen Sie dem Ereignis die Aktivierungs-ID; haben Sie sie bereits verarbeitet, geben Sie Erfolg zurück und tun nichts weiter.

Die letzte Regel hält den Handler idempotent, sodass ein erneuter Versand nach einem Netzwerkaussetzer den Test nie durcheinanderbringt. Eine ausführlichere Behandlung finden Sie unter Webhook-basierte OTP-Erfassung.

Welche Endpunkte und IDs verwendet eine +592-Bestellung?

Authentifizieren Sie sich mit einem Bearer-Schlüssel aus der Developer-Konsole; Live-Schlüssel beginnen mit or_live_, und jedes Konto kann bis zu 10 behalten. Die Basis-URL lautet https://otproute.com/api/v1, und die Länder-ID für Guyana ist gy.

Ein typischer Durchlauf liest zuerst GET /api/v1/prices?country=gy&service=<id>, denn Preis und Verfügbarkeit auf dieser Route sind Live-Werte und keine Konstanten. Danach sendet er POST /api/v1/activations mit {"service": "<id>", "country": "gy"} und erhält eine +592-Nummer samt Aktivierungs-ID. Ohne Webhook fragt der Runner alle paar Sekunden GET /api/v1/activations/{id} ab, weit unter der Obergrenze von 300 Anfragen pro Minute. Ein Teardown-Schritt ruft POST /api/v1/activations/{id}/cancel auf, wenn der Test abbricht, und ein Vorab-Aufruf von GET /api/v1/balance stoppt die Suite frühzeitig, wenn das Guthaben knapp ist. Dienst-IDs stammen von GET /api/v1/services; im Developer-Hub finden Sie Client-Beispiele für diese SMS-Verifizierungs-API.

Wie werden +592-Nummern zur Speicherung formatiert?

Guyana verwendet die Landesvorwahl 592 und siebenstellige nationale Nummern ohne Ortsnetz-Präfix, das entfernt werden müsste. Die E.164-Form ist also einfach +592 gefolgt von diesen sieben Ziffern. Üblicherweise schreibt man die Ziffern als Gruppe von drei und eine Gruppe von vier.

Da es keine führende Null zu entfernen gibt, beschränkt sich die Normalisierung darauf, Leerzeichen und Bindestriche zu löschen und die Landesvorwahl zu ergänzen, wenn jemand nur die lokalen Ziffern eingibt. Ein häufiger Fehler ist ein Formular, das bei jeder südamerikanischen Nummer eine Ortsvorwahl voraussetzt oder eine Mindestlänge über sieben Ziffern verlangt und deshalb gültige guyanische Eingaben ablehnt. Eine +592-Nummer zum Testen deckt das schnell auf. Speichern Sie den E.164-String und wenden Sie lokale Formatierung erst bei der Anzeige an.

Welche Dienste können Guyana-SMS-OTP-Codes empfangen, und kann ich manuell bestellen?

Die Guyana-Route führt mehr als 900 Dienste. Häufig angefragt werden WhatsApp, Facebook, Instagram, Google (Gmail & YouTube), TikTok, Telegram, imo, Viber, Snapchat, Amazon, Microsoft & Outlook, Discord, Netflix und Claude. Diese Liste ist eine Momentaufnahme des Live-Katalogs. Bestätigen Sie daher über die API oder das Dashboard, bevor Sie einen Test um einen bestimmten Absender herum planen.

Für Kollegen, die keinen Code schreiben, erledigt das Dashboard dieselbe Aufgabe. Melden Sie sich an, öffnen Sie das OTP Gateway, wählen Sie Guyana und einen Dienst, prüfen Sie den Preis und bestellen Sie. Die Guyana-Verifizierungsnummer erscheint zusammen mit einem 20-Minuten-Countdown, und der Code wird bei Eingang daneben angezeigt.

Was sollte ein Test tun, wenn der +592-Code spät kommt oder ausbleibt?

Eine Aktivierung bleibt 20 Minuten lang offen. Sie zahlen nur, wenn der Code innerhalb dieses Fensters eintrifft; läuft sie ab oder brechen Sie ab, wird der volle Betrag ohne Support-Ticket auf das Guthaben zurückgebucht.

Sinnvolles Vorgehen in einem automatisierten Lauf:

1. Warten Sie das Fenster ab, bevor Sie einen Fehler feststellen, es sei denn, Ihr Test hat ein hartes Zeitlimit; dann brechen Sie ausdrücklich ab.
2. Versuchen Sie es später erneut oder wechseln Sie auf eine andere Dienstroute, falls die API eine anbietet.
3. Prüfen Sie, ob der Zieldienst virtuelle Nummern akzeptiert; manche lehnen sie ab, und die Erstattung deckt genau diesen Fall ab.
4. Staffeln Sie Wiederholungen mit einem Backoff, statt in enger Schleife neu zu bestellen.

Der Leitfaden zum Länder-Routing für OTP erklärt, wie Sie Ausweichrouten wählen.

Warum testen Teams guyanische Registrierungsabläufe?

Guyana ist das einzige südamerikanische Land mit Englisch als Amtssprache, und Georgetown beherbergt das CARICOM-Sekretariat, weshalb es häufig in Rollouts auftaucht, die die Karibische Gemeinschaft als einen Markt behandeln. Ein schnell wachsender Offshore-Energiesektor hat internationale Auftragnehmer und Zulieferer angezogen, während eine große Diaspora in den Vereinigten Staaten, Kanada und im Vereinigten Königreich Überweisungs-, Messaging- und Reise-Apps auf +592-Nummern beschäftigt hält. Guyanisches Kreolisch wird im Alltag weithin gesprochen, doch Verifizierungstexte kommen in der Regel auf Englisch. Für die QA richtet das den Aufwand auf Nummerneingabe, Länderauswahl und Formulierungen zur SMS-Einwilligung statt auf übersetzte Texte. Beschränken Sie alle Prüfungen auf Konten, die Ihrer Organisation gehören, beachten Sie die Bedingungen jedes Dienstes und denken Sie daran, dass die Richtlinie zur akzeptablen Nutzung von OTP Route für alle Bestellungen gilt.

Kann ich eine guyanische Leitung behalten, und wie wird die Nutzung abgerechnet?

Für Guyana werden keine langfristigen Self-Service-Nummern angeboten. Die Dedizierten Nummern von OTP Route gibt es nur für die Vereinigten Staaten und Kanada, ab $1.95/Monat. Für eine +592-Leitung schreiben Sie an [email protected]; das Team prüft, was die lokalen Vorschriften erlauben, ohne etwas zuzusagen.

Die Zahlung läuft über ein einziges prepaid USD-Guthaben: keine Monatsgebühr, kein Tarif, Aufladung per Karte oder USDT/USDC und für jede Aufladung eine PDF-Rechnung per E-Mail. Ein Entwicklungskonto lässt sich auf Anfrage in die Sandbox verschieben, sodass Integrationstests mit simulierten Nummern und Codes laufen und das Guthaben unberührt bleibt. Die Preise je Dienst finden Sie auf der Preisseite.

Häufige Fragen

Kann ich die Guyana-Registrierung meiner App prüfen, ohne SIM-Karte eines guyanischen Anbieters?

Ja. Bestellen Sie im OTP Gateway eine +592-Nummer für Ihren Dienst, geben Sie sie in Ihrem Ablauf ein, und der Code erscheint im Dashboard oder erreicht Ihren Webhook. Die Preise beginnen bei $0.20 pro Code.

Welche Länder-ID verwendet die API für Guyana?

Sie lautet gy und wird sowohl in der Preisabfrage als auch im Body der Aktivierungsanfrage verwendet.

Muss ich bei guyanischen Nummern eine führende Null entfernen?

Nein. Guyana hat kein Ortsnetz-Präfix, daher lautet die E.164-Form +592 gefolgt von der siebenstelligen Nummer.

In welcher Sprache kommen +592-Verifizierungsnachrichten?

Meist auf Englisch, der Amtssprache. Den Wortlaut bestimmt allerdings der Absender, der sich auch nach der Spracheinstellung der App richten kann.

Gibt es eine Erstattung, wenn der Dienst nie eine SMS sendet?

Ja, und zwar automatisch. Vergehen 20 Minuten ohne Code oder brechen Sie ab, geht der gesamte Betrag auf Ihr Guthaben zurück.

Kann ich die gesamte Integration testen, ohne Geld auszugeben?

Bitten Sie den Support, Ihr Entwicklungskonto auf Sandbox umzustellen. Sie liefert simulierte Nummern und Codes, sodass API-Aufrufe und Webhooks vollständig durchgespielt werden können.

Gibt es eine langfristige +592-Nummer?

Nicht als Self-Service-Produkt. Dedizierte Nummern werden nur in den Vereinigten Staaten und Kanada verkauft; für Guyana fragen Sie per E-Mail an [email protected] nach.

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.