X-(Twitter)-SMS-Codes empfangen: eine Checkliste für Produkt- und QA-Teams

Wofür verlangt X eine Telefonnummer?

X nutzt Telefonnummern an einigen bekannten Stellen: als Alternative zur E-Mail bei der Registrierung, wenn Sie einem bestehenden Konto eine Nummer hinzufügen, bei Login-Abfragen nach auffälliger Aktivität, beim Zurücksetzen des Passworts und für die Zwei-Faktor-Authentifizierung per Textnachricht. X hat im Lauf der Jahre eingegrenzt, welche Konten SMS-Zwei-Faktor nutzen können, und bietet Authenticator-Apps als Option an. Prüfen Sie daher die aktuellen Einstellungen des Kontos, das Sie testen. Jeder dieser Abläufe sendet einen kurzen numerischen Code, und jeder sollte abgedeckt werden, wenn Ihr Produkt X-Konten einbindet oder verwaltet. Typische Fälle sind ein Social-Media-Tool, das Markenkonten onboardet, eine Agentur, die Kundenprofile über einen gemeinsamen Team-Login betreibt, und eine QA-Suite, die prüft, wie sich Ihre eigene App verhält, nachdem ein Nutzer ein X-Profil verknüpft hat.

Checkliste für das Testen der X-(Twitter)-SMS-Verifizierung

• Eigentum. Das Konto gehört Ihnen, Ihrem Unternehmen oder einem Kunden, der Sie mit der Verwaltung beauftragt hat. Ein Konto pro realer Person oder Unternehmen.
• Bedingungen. Lesen Sie die Regeln von X zu Telefonnummern und Automatisierung; sie gelten zusätzlich zu unserer Acceptable Use Policy.
• Land. Legen Sie vor der Bestellung fest, welchen Markt das Konto darstellt.
• Service-ID. Bei OTP Route lautet die Service-ID für X twitter.
• Technik. Ein Bearer-Schlüssel (or_live_) und entweder eine Polling-Schleife oder ein Webhook-Endpunkt.
• Lebensdauer. Muss sich dieses Konto in einem Monat erneut anmelden? Falls ja, lesen Sie den Abschnitt zur dedizierten Leitung, bevor Sie beginnen.

Aus welchem der 198 Länder sollte die Nummer stammen?

Die X-Route deckt 198 Länder ab, darunter die USA, Kanada, das Vereinigte Königreich, Deutschland, Frankreich, Indien, Indonesien, die Philippinen, Japan, Brasilien, Mexiko, die Türkei, Saudi-Arabien, Kenia, Nigeria und Ghana. Passen Sie die Nummer an den Markt an, den das Konto bedient, oder an den Testfall, den Sie belegen wollen: Ein regionales Markenkonto sollte eine Nummer aus seiner Region tragen, und ein Lokalisierungstest braucht Sprache und Nummernformat dieses Landes. Eine Abweichung zwischen Nummer, IP-Standort und Profil ist zudem genau das Signal, das auf Seiten von X zusätzliche Prüfungen auslösen kann.

Schritte: eine Nummer für X über die API bestellen

Basis-URL: https://otproute.com/api/v1.

1. Rufen Sie den Preis für Ihr Paar mit GET /api/v1/prices?country=<id>&service=twitter ab, was zugleich die Live-Verfügbarkeit bestätigt.
2. Legen Sie die Bestellung an: POST /api/v1/activations mit {"service": "twitter", "country": "<id>"}. Speichern Sie die Aktivierungs-ID.
3. Geben Sie die zurückgegebene Nummer in das Telefonfeld von X ein.
4. Holen Sie den Code aus dem Webhook-Ereignis oder fragen Sie GET /api/v1/activations/{id} ab, bis er erscheint.
5. Lehnt X die Nummer ab, geben Sie sie mit POST /api/v1/activations/{id}/cancel frei.

Länder-IDs stammen aus GET /api/v1/countries; die API-Dokumentation zeigt Anfrage- und Antwortformate.

Wie sollte der Webhook-Empfänger aufgebaut sein?

Abonnieren Sie activation.sms_received, activation.expired und activation.cancelled. Jede Zustellung trägt X-OTPRoute-Signature: t=<unix>,v1=<hex>; berechnen Sie HMAC-SHA256 über den Zeitstempel, einen Punkt und den rohen Body mit dem Endpunkt-Secret, vergleichen Sie in konstanter Zeit und lehnen Sie alte Zeitstempel ab. Da Zustellungen sich wiederholen können, speichern Sie verarbeitete Aktivierungs-IDs und ignorieren Sie Duplikate. Für kleine Suites ist Polling ein guter Ausweichweg, weit unter 300 Anfragen pro Minute. Der HMAC-Leitfaden enthält ein ausgearbeitetes Beispiel.

Lieber klicken? Öffnen Sie im Dashboard das OTP Gateway, wählen Sie X und ein Land, bestätigen Sie den angezeigten Preis, fügen Sie die Nummer in X ein und beobachten Sie, wie der Code neben der Bestellung erscheint.

Fehlersuche: X hat keinen Code gesendet

• Die Nummer wurde abgelehnt. X kann virtuelle Nummern ablehnen, manchmal mit dem Hinweis, dass die Nummer nicht verwendet werden kann. Brechen Sie ab und versuchen Sie es später oder mit einem anderen Land erneut.
• Es ist noch nichts angekommen. Lassen Sie das 20-Minuten-Fenster offen, statt sofort erneut zu bestellen.
• X drosselt. Wiederholte Anfragen von einem Konto können die eigenen Limits von X auslösen; verteilen Sie die Versuche.
• Ihr Handler hat ihn verworfen. Prüfen Sie Signaturfehler und Fehlermeldungen in Ihren Logs.
• Das Konto ist markiert. Hat X das Konto selbst eingeschränkt, ändert eine neue Nummer daran nichts; klären Sie es über die eigenen Support-Kanäle von X.

Die Erstattungsregel nimmt dem Fehlschlag die Kosten: Sie zahlen nur, wenn der Code ankommt, und abgelaufene oder abgebrochene Aktivierungen erstatten den vollen Betrag ins Guthaben.

Wann passt eine dedizierte US- oder Kanada-Leitung besser?

Eine einmalige Aktivierung genügt für eine einzelne Verifizierung. Ein Firmenkonto, das Monate später Login-Abfragen bestehen oder den Zugang wiederherstellen muss, braucht eine Nummer, die bleibt. Dedicated Numbers bieten das in den USA und Kanada ab $1.95/Monat: eingehende SMS im Dashboard und auf Ihrem Webhook über number.sms_received, ausgehende SMS und Telefonieren im Browser. Beide Produkte im Vergleich finden Sie unter virtuelle Nummern. OTP Route rechnet alles über ein Prepaid-Guthaben ab, das per Karte oder USDT/USDC aufgeladen wird, mit PDF-Rechnungen.

Häufige Fragen

Wie lautet die Service-ID für X (Twitter) in der OTP-Route-API?

Sie lautet twitter. Verwenden Sie sie in der Preisabfrage und im Body der Aktivierung.

Kann ich einen X-OTP ohne SIM-Karte empfangen?

Ja, auf einer OTP-Gateway-Nummer in jedem der 198 Länder, angezeigt im Dashboard oder an Ihren Webhook gesendet.

Warum sagt X, meine Telefonnummer könne nicht verwendet werden?

X kann manche virtuelle Nummern ablehnen. Brechen Sie die Aktivierung für eine Erstattung ab und versuchen Sie es mit einem anderen Land oder zu einem späteren Zeitpunkt.

Was kostet ein X-Verifizierungscode?

Ab $0.20 pro Code; der genaue Preis hängt vom Land ab und wird vor der Bestellung angezeigt.

Kann ich dieselbe Nummer später für den X-Login wiederverwenden?

Eine Einmal-Aktivierung empfängt einen Code. Für wiederholte Anmeldungen nutzen Sie eine dedizierte Nummer in den USA oder Kanada.

Kann ich OTP Route nutzen, um viele X-Konten anzulegen?

Nein. Es dient dazu, Ihre eigenen legitimen Konten und Produkte im Rahmen der Bedingungen von X zu testen und zu betreiben.

Gibt es eine Sandbox zum Entwickeln der Integration?

Ja. Auf Anfrage kann ein Entwicklungskonto in den Sandbox-Modus wechseln und simulierte Nummern und Codes liefern.

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.