Verifizierungscodes aus Kap Verde (+238) in den eigenen Test-Stack holen

Welche Endpunkte berührt eine +238-Aktivierung?

Eine Integration der Cabo-Verde-OTP-API braucht nur eine kurze Liste von Aufrufen unter https://otproute.com/api/v1. Jede Anfrage trägt einen Bearer-Schlüssel mit dem Präfix or_live_, der in der Developer-Konsole erzeugt wird. Die Länder-ID für Cabo Verde ist cv; die Service-ID ist der api_service-Wert der App, die Sie testen.

1. GET /api/v1/services und GET /api/v1/countries liefern die Kataloge; cachen Sie sie für den Tag.
2. GET /api/v1/prices?country=cv&service=<id> liest den aktuellen Preis und zeigt, ob eine Route gerade offen ist. Der Bestand ändert sich im Tagesverlauf, fragen Sie ihn also vor jeder Bestellung ab, statt etwas fest zu codieren.
3. POST /api/v1/activations mit {"service": "whatsapp", "country": "cv"} liefert eine Aktivierungs-ID und die +238-Nummer, die Sie in Ihr Registrierungsformular eintippen.
4. Mit GET /api/v1/activations/{id} fragen Sie den Code per Polling ab, wenn Sie keine Webhooks verwenden.
5. POST /api/v1/activations/{id}/cancel gibt die Nummer frei, wenn ein Test abbricht, sodass die Reservierung ans Guthaben zurückgeht.

Ein Aufruf von GET /api/v1/balance vor dem Lauf lässt eine Suite früh stoppen, statt auf halber Strecke zu scheitern. Die Obergrenze liegt bei 300 Anfragen pro Minute und Konto, und die API-Referenz listet jedes Feld auf.

Wie nehme ich den signierten Webhook für einen Cabo-Verde-Code an?

Polling genügt für ein einzelnes Skript; sobald mehrere Jobs parallel laufen, ist ein Webhook aufgeräumter. Registrieren Sie in der Developer-Konsole einen Endpunkt (ein Konto kann fünf halten) und abonnieren Sie activation.sms_received, activation.expired und activation.cancelled.

Jeder POST kommt mit einem Header X-OTPRoute-Signature der Form t=<unix>,v1=<hex>. Bauen Sie den String <t>.<raw body> nach, signieren Sie ihn mit HMAC-SHA256 und dem Secret dieses Endpunkts und vergleichen Sie das Ergebnis mit v1 per Vergleich in konstanter Zeit. Verwerfen Sie alles, dessen Zeitstempel mehr als ein paar Minuten alt ist, damit eine abgefangene Anfrage nicht erneut eingespielt werden kann. Danach ordnen Sie Ihre Verarbeitung der Aktivierungs-ID zu: Trifft dasselbe Ereignis zweimal ein, darf die zweite Kopie nichts ändern. Unser Artikel zum Absichern von OTP-Webhooks mit HMAC behandelt die Sonderfälle.

Welche Apps können heute Codes an eine kapverdische Nummer senden?

Der Live-Katalog für cv umfasst mehr als 800 Dienste. Zu den beliebten, derzeit offenen gehören WhatsApp, Facebook, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Amazon, Airbnb, Uber, Viber, Telegram und Netflix. Verstehen Sie diese Liste als Momentaufnahme: Routen öffnen und schließen sich mit der Kapazität der Partner, und genau darum geht es beim OTP-Routing über eine API, die die Verfügbarkeit in Echtzeit meldet, statt über eine Seite, die sie nur verspricht.

Wenn im Team niemand programmiert, erledigt das Dashboard dieselbe Aufgabe. Wählen Sie den Dienst, wählen Sie Cabo Verde, bestätigen Sie den Preis auf dem Bildschirm und kopieren Sie die Nummer. Der Code erscheint auf der Aktivierungskarte, sobald er eintrifft.

Wie sieht eine +238-Nummer beim Speichern aus?

Cabo Verde verwendet einen geschlossenen Nummerierungsplan: siebenstellige nationale Nummern und kein Trunk-Präfix, es gibt also keine führende Null zu entfernen. Im E.164-Format ist eine Nummer schlicht +238 gefolgt von diesen sieben Ziffern. Die Normalisierung ist damit trivial, doch die kurze Länge bringt Validatoren aus dem Tritt, die jede Teilnehmernummer für länger halten, ein häufiger Grund, warum ein Formular eine völlig gültige kapverdische Eingabe ablehnt. Speichern Sie den E.164-String, formatieren Sie ihn in der Oberfläche nach Belieben und nehmen Sie einen +238-Fall in die Unit-Tests Ihres Telefonfelds auf.

Portugiesisch ist Amtssprache, während im Alltag meist Kapverdisches Kreol gesprochen wird; prüfen Sie daher, wie eine portugiesische OTP-Vorlage auf einem Gerät dort dargestellt wird. Teams holen sich eine +238-Nummer zum Testen meist wegen der Diaspora: Kapverdische Gemeinschaften in den Vereinigten Staaten, Portugal und anderswo in Europa halten Konten, die an Nummern in der Heimat gebunden sind, und Überweisungs-, Reise- und Messaging-Produkte wollen, dass diese Registrierungen funktionieren.

Was passiert mit dem Guthaben, wenn innerhalb von 20 Minuten keine SMS ankommt?

Jede Aktivierung bleibt 20 Minuten offen. Kommt in diesem Fenster ein Code an, bleibt die Abbuchung bestehen; läuft das Fenster leer ab oder brechen Sie vorher ab, geht der volle Betrag ohne Support-Ticket zurück ans Guthaben. Wenn nichts durchkommt:

• Lassen Sie das Fenster ablaufen, statt alle paar Sekunden eine neue Bestellung abzusetzen; eine enge Retry-Schleife blockiert nur Guthaben.
• Versuchen Sie es später erneut oder testen Sie denselben Ablauf über eine andere Dienstroute.
• Prüfen Sie, ob die App virtuelle Nummern überhaupt akzeptiert; manche lehnen sie per Richtlinie ab, und genau für diesen Fall gibt es die Erstattung.
• Stellen Sie sicher, dass Ihr Formular die vollständige +238-Nummer übermittelt hat und keine gekürzte.

Der Leitfaden zum Verringern fehlgeschlagener OTP-Zustellungen geht tiefer auf die Diagnose ein.

Kann ich eine Cabo-Verde-Nummer für wiederholte Anmeldungen behalten?

Nicht per Self-Service. Dedicated Numbers von OTP Route, also langfristige Leitungen mit ein- und ausgehenden SMS, Telefonie im Browser und Webhook-Weiterleitung, sind ein Produkt für die Vereinigten Staaten und Kanada ab $1.95/Monat. Eine selbst buchbare langfristige +238-Leitung gibt es nicht. Wenn Ihr Team tatsächlich eine braucht, schreiben Sie an [email protected]; ob sich das einrichten lässt, hängt von den lokalen Vorschriften ab und ist nicht zugesichert. Für ein Staging-Konto, das sich immer wieder anmelden muss, ist eine US-amerikanische oder kanadische virtuelle Nummer oft die praktische Lösung.

Wie wird die Nutzung abgerechnet und vor dem Livegang getestet?

Die Abrechnung läuft über ein einziges vorausbezahltes USD-Guthaben ohne monatliche Gebühr und ohne Tarifstufe. Laden Sie per Karte oder mit USDT/USDC-Stablecoins auf; zu jeder Aufladung gibt es eine PDF-Rechnung per E-Mail, was den Abgleich in der Buchhaltung einfach hält. Bevor Produktionsschlüssel das Guthaben berühren, beantragen Sie die Umstellung Ihres Entwicklungskontos auf Sandbox: Es liefert simulierte Nummern und Codes, sodass Bestell-, Webhook- und Abbruchpfad Ihres SMS-Verifizierungs-API-Clients in der CI laufen können, ohne etwas auszugeben. Siehe Preise und die Übersicht zum QA-Testing. Beachten Sie durchgehend die Bedingungen der jeweiligen Dienste und die Acceptable Use Policy von OTP Route.

Häufige Fragen

Kann ich den Registrierungsablauf meiner App für Cabo Verde ohne lokale SIM-Karte testen?

Ja. Bestellen Sie im OTP Gateway eine +238-Nummer, geben Sie sie in Ihr Registrierungsformular ein und lesen Sie den Code im Dashboard, über die API oder per Webhook. Niemand im Team muss auf den Inseln sein.

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

Sie lautet cv. Übergeben Sie sie als country in POST /api/v1/activations und in der Preisabfrage.

Muss ich einer kapverdischen Nummer eine 0 voranstellen?

Nein. Cabo Verde hat kein Trunk-Präfix, die internationale Form besteht also nur aus +238 plus der siebenstelligen nationalen Nummer.

Was kostet eine Verifizierungsnummer für Cabo Verde?

Die Preise des OTP Gateway beginnen ab $0.20 pro Code und variieren je nach Dienst; API und Dashboard zeigen den genauen Preis vor der Bestellung. Berechnet wird nur, wenn ein Code ankommt.

Senden alle Apps Codes an eine virtuelle kapverdische Nummer?

Nein. Manche Dienste lehnen virtuelle Nummern ab, und Routen ändern sich im Tagesverlauf. Kommt innerhalb von 20 Minuten kein Code an, wird der Betrag dem Guthaben gutgeschrieben.

Gibt es eine Sandbox zum Testen der +238-Integration?

Ja, auf Anfrage. Ein Entwicklungskonto kann in den Sandbox-Modus umgestellt werden, der simulierte Nummern und Codes liefert, sodass die Integration durchgängig ohne Guthabenverbrauch läuft.

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.