ReOTP.
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 Methode WHATSAPP ist).
  • tgLink (String): Telegram-Link (wird nur zurückgegeben, wenn die Methode TELEGRAM ist).
  • 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)
curl -X POST https://[your-domain.com]/api/verify/init \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "method": "WHATSAPP"
  }'
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"
  }'