API-Schnittstelle/1. Verifikation initialisieren
2 min read
1. Verifikation initialisieren
Neue Verifikationssitzung starten & Verbindungsserver aufwecken.
Das ReOTP-System nutzt die Wake-on-Demand-Funktion, um Serverressourcen zu schonen. Dies bedeutet, dass Ihre WhatsApp-Verbindung inaktiv ist und der Server bei dieser Anfrage aktiviert wird, um die Verbindung herzustellen und für den Empfang der Kundennachricht bereit zu sein.
Request Body:
apiKey(String - Erforderlich): Ihr Projekt-API-Schlüssel.
phoneNumber(String - Erforderlich): Die Telefonnummer des Benutzers (Beispiel:+966500000000).
method(String - Optional): Die Verifizierungsmethode"WHATSAPP"oder"TELEGRAM"(Standard:"WHATSAPP").
returnUrl(String - Optional): Die URL, zu der der Kunde nach erfolgreicher Verifizierung in der Telegram-App weitergeleitet wird.
Response Body:
requestId(String): Eindeutige Vorgangs-ID zur Verfolgung des Verifizierungsstatus.
waLink(String): WhatsApp-Link (wird nur zurückgegeben, wenn die MethodeWHATSAPPist).
tgLink(String): Telegram-Link (wird nur zurückgegeben, wenn die MethodeTELEGRAMist).
expectedText(String): Der erwartete Text der automatischen Nachricht, die gesendet werden soll.
expiresIn(String): Ablaufzeit der Anfrage (2 Minuten).
Wichtige Hinweise:
- Gültigkeitsdauer: Der Kunde hat nur zwei Minuten (02:00) Zeit, den Link zu öffnen und die automatische Nachricht von seinem Telefon zu senden, bevor die Sitzung abläuft und der Server wieder in den Ruhemodus wechselt.
- Benutzeroberfläche: Wir empfehlen dringend, dem Kunden auf Ihrer Oberfläche einen Countdown anzuzeigen, um ihn zum schnellen Senden der Nachricht aufzufordern.
Senden Sie eine POST-Anfrage an den in der seitlichen Code-Leiste angezeigten Link, um den Vorgang zu starten.
Integration Code (SDKs)
Interactive Playground
Interactive API Console
Enter phone number to initialize and test server response instantly:
Interaktiver Live-API-Playground
Testen Sie den Live-Versand von Verifikationsanfragen und generieren Sie Integrationscode in Ihrer bevorzugten Programmiersprache.
curl -X POST https://reotp.com/api/verify/init \
-H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "201000000000",
"method": "WHATSAPP"
}'