Botswana-SMS-Codes über einen API-Aufruf empfangen

Welche API-Aufrufe durchläuft eine Botswana-Aktivierung?

Alles liegt unter https://otproute.com/api/v1 und wird mit einem Bearer-Schlüssel authentifiziert, der mit or_live_ beginnt. Schlüssel erstellen Sie in der Developer-Konsole; ein Konto kann bis zu 10 davon halten, und das Limit liegt bei 300 Anfragen pro Minute – reichlich für eine Testsuite, die pro Lauf eine Handvoll Botswana-Nummern bestellt.

Ein typischer Ablauf sieht so aus:

1. Rufen Sie einmal GET /api/v1/countries auf und cachen Sie das Ergebnis, damit Ihr Code weiß, dass bw die Kennung für Botswana ist.
2. Fragen Sie GET /api/v1/prices?country=bw&service=whatsapp nach Live-Preis und Verfügbarkeit der gewünschten Kombination. Preise variieren je nach Dienst und Land, lesen Sie sie also aus, statt sie fest zu codieren.
3. Senden Sie POST /api/v1/activations mit dem Body {"service": "whatsapp", "country": "bw"}. Die Antwort enthält die +267-Nummer und eine Aktivierungs-ID.
4. Geben Sie diese Nummer im Registrierungsformular ein, das Sie testen, und fragen Sie dann entweder GET /api/v1/activations/{id} per Polling ab oder warten Sie auf einen Webhook.
5. Wird der Test abgebrochen, rufen Sie POST /api/v1/activations/{id}/cancel auf, damit das Geld sofort ins Wallet zurückgeht.

Der Leitfaden zur OTP-API-Integration geht dieselben Aufrufe mit Blick auf die Fehlerbehandlung durch.

Wie sollte mein Webhook-Empfänger +267-Ereignisse behandeln?

Webhooks sind die sauberere Wahl, sobald mehr als ein Test parallel läuft. Registrieren Sie einen Endpoint (fünf pro Konto) und lauschen Sie auf activation.sms_received, activation.expired und activation.cancelled, jeweils bezogen auf die Aktivierungs-ID, die Sie bei der Bestellung erhalten haben.

Jede Zustellung trägt einen Header X-OTPRoute-Signature in der Form t=<unix>,v1=<hex>. Bauen Sie das HMAC-SHA256 des Strings "<t>.<raw body>" mit dem Endpoint-Secret nach, vergleichen Sie es konstantzeitlich mit v1 und verwerfen Sie alles mit veraltetem Zeitstempel. Parsen Sie das JSON erst nach bestandener Prüfung, denn eine erneute Serialisierung des Bodys verändert die Bytes.

Machen Sie den Handler idempotent: Speichern Sie die Aktivierungs-ID, wenn der Code verbraucht wird, und ignorieren Sie eine Wiederholung desselben Ereignisses. Details stehen in Absichern von OTP-Webhooks mit HMAC.

Wofür lässt sich eine Botswana-Verifizierungsnummer verwenden?

Der Live-Snapshot für Botswana listet mehr als 800 Dienste. Zu den beliebten gehören WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft & Outlook, Amazon, LinkedIn, Uber, Signal, Netflix und Airbnb.

Die Verfügbarkeit auf einer Route verschiebt sich im Tagesverlauf, wenn sich die Carrier-Kapazität ändert. Deshalb meldet der Preis-Endpoint auch, was gerade bestellbar ist: Betrachten Sie seine Antwort als maßgebliche Quelle, nicht diese Liste.

Was sollten Entwickler über botswanische Telefonnummern wissen?

Botswana verwendet die Landesvorwahl +267 und hat keine nationale Vorwahl, die Nummer wird also so gewählt, wie sie geschrieben ist. Mobilnummern haben acht Ziffern und beginnen mit 7. In E.164 ergibt das +267 gefolgt von den acht Ziffern, ohne Null zum Entfernen.

Einige praktische Hinweise für alle, die diese Nummern speichern oder validieren:

• Normalisieren Sie bei der Eingabe alles auf E.164. Nutzer tippen vielleicht 00267, Leerzeichen oder ein führendes Plus; reduzieren Sie alles auf eine kanonische Form, bevor Sie vergleichen oder deduplizieren.
• Übernehmen Sie keine Vorwahlregel eines Nachbarmarkts. Ein Validator aus einem Land, das eine führende Null entfernt, weist gültige Botswana-Einträge ab.
• Englisch und Setswana sind die Hauptsprachen. Codes globaler Apps kommen meist auf Englisch an, doch Ihr Parser sollte Ziffern per Muster extrahieren, statt sich auf feste Formulierungen zu stützen.

Teams testen hier, wenn sie ein Produkt im südlichen Afrika starten, das Onboarding für Kunden jenseits der Grenze zu Südafrika prüfen oder regionale Abläufe betreiben, die eine lokale +267-Nummer zum Testen brauchen.

Kann ein Nicht-Entwickler einen Botswana-Code im Dashboard bestellen?

Ja. Registrieren Sie sich mit Ihrer E-Mail und einem sechsstelligen Code (oder über Google), laden Sie das Wallet auf, öffnen Sie dann das OTP Gateway, wählen Sie Botswana und den Dienst, prüfen Sie den angezeigten Preis und bestellen Sie. Fügen Sie die Nummer in die zu testende App ein; der Code erscheint im Dashboard, sobald die SMS die Route erreicht.

Jede Aktivierung bleibt 20 Minuten offen. Kommt in dieser Zeit keine Nachricht an oder brechen Sie vorher ab, geht der volle Betrag automatisch in Ihr Wallet zurück.

Was tun, wenn der Botswana-Code nicht ankommt?

Die Zustellgeschwindigkeit hängt vom Dienst und von der Route ab; geben Sie dem Fenster daher Zeit, bevor Sie handeln. Läuft es leer ab, gehen Sie diese Liste durch:

• Versuchen Sie es etwas später erneut oder wählen Sie für denselben Ablauf eine andere Dienstroute, falls Ihr Produkt das unterstützt.
• Prüfen Sie, ob die App am anderen Ende bereit ist, an eine virtuelle Nummer zu senden; einige Apps weisen solche Nummern ab, und genau deshalb fließen ungenutzte Aktivierungen auf Ihr Guthaben zurück.
• Lassen Sie das 20-Minuten-Fenster ablaufen, statt nach einer Minute abzubrechen.
• Vermeiden Sie enge Neubestell-Schleifen aus CI; bauen Sie zwischen den Versuchen ein Back-off ein.

Weitere Muster finden Sie unter weniger fehlgeschlagene OTP-Zustellungen. Was auch immer Sie testen: Beachten Sie die Bedingungen des jeweiligen Dienstes; die Acceptable Use Policy von OTP Route gilt für jede Bestellung.

Gibt es eine +267-Langzeitnummer, und wie funktioniert die Abrechnung?

Nicht als Selbstbedienungsprodukt. Dedicated Numbers werden sofort nur in den USA und Kanada verkauft, ab $1.95/Monat; für Botswana können Sie an [email protected] schreiben und nachfragen, wobei die Verfügbarkeit von den lokalen Vorschriften abhängt. Was die US-amerikanischen und kanadischen Nummern enthalten, steht unter virtuelle Nummern.

Abgerechnet wird über ein vorausbezahltes USD-Wallet ohne Monatsgebühr, aufgeladen per Karte oder mit USDT/USDC, und zu jeder Aufladung kommt eine PDF-Rechnung per E-Mail. Für Integrationsarbeit kann ein Entwicklungskonto auf Anfrage auf Sandbox umgestellt werden, sodass der gesamte Ablauf mit simulierten Nummern und Codes läuft. Die aktuellen Preise stehen auf der Seite Preise.

Häufige Fragen

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

Sie lautet bw. Übergeben Sie sie als country in POST /api/v1/activations und im Query-String von GET /api/v1/prices.

Kann ich den Registrierungsablauf meiner App für Botswana ohne lokale SIM testen?

Ja. Bestellen Sie über das OTP Gateway eine +267-Nummer für den Dienst Ihrer App und lesen Sie den Code im Dashboard oder an Ihrem Webhook aus – ganz ohne SIM-Karte oder Telefon.

Brauchen Botswana-Nummern beim Speichern eine führende Null?

Nein. Botswana hat keine nationale Vorwahl; speichern Sie die Nummer als +267 plus die achtstellige Mobilnummer.

Werde ich belastet, wenn der +267-Code nicht durchkommt?

Nein. Kommt innerhalb des 20-Minuten-Fensters nichts an oder brechen Sie ab, geht der volle Betrag automatisch in Ihr Wallet zurück.

Kann ich eine Botswana-Nummer für künftige Logins behalten?

Für Botswana gibt es keine selbst buchbare Langzeitnummer. Langzeitnummern sind ein Produkt für die USA und Kanada; schreiben Sie an [email protected], wenn Sie nach anderen Möglichkeiten fragen möchten.

Kann ich Botswana-Tests in CI laufen lassen, ohne Wallet-Guthaben auszugeben?

Bitten Sie darum, Ihr Entwicklungskonto auf Sandbox umzustellen. Es liefert simulierte Nummern und Codes, sodass sich der gesamte API- und Webhook-Pfad kostenlos ausführen lässt.

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.