SIM Swap

SIM Swap (SIM-Kartenwechsel) bezeichnet den Vorgang, bei dem die Telefonnummer eines Benutzers an eine neue SIM-Karte gebunden wird. Dies geschieht typischerweise in folgenden Szenarien: Verlustmeldung und Ersatzkarte, Upgrade der SIM-Karte, Rufnummernmitnahme (Portierung), Aktivierung von Multi-SIM-Diensten oder wenn ein neuer Benutzer eine Nummer übernimmt, die zuvor von einer anderen Person verwendet wurde.

Angreifer können SIM Swap nutzen, um die Telefonnummer einer anderen Person zu kapern, SMS-Verifizierungscodes abzufangen und anschließend Passwörter zurückzusetzen sowie Konten zu übernehmen. Die SIM Swap API kann in Echtzeit erkennen, ob für eine bestimmte Telefonnummer ein SIM-Kartenwechsel stattgefunden hat. Dies hilft Unternehmen, potenzielle SIM-Hijacking-Risiken in kritischen Prozessen wie der SMS-OTP-Verifizierung zu identifizieren und die Wahrscheinlichkeit einer Kontoübernahme zu verringern.

Hinweis: Derzeit wird die SIM Swap-Abfrage nur für Nummern in den folgenden Ländern/Regionen unterstützt: Brasilien, Indonesien.

Diese API bietet zwei unabhängige Endpunkte:

• Retrieve Date: Abfrage des Zeitpunkts des letzten SIM Swaps für eine bestimmte Telefonnummer
• Check: Erkennung, ob für eine bestimmte Telefonnummer innerhalb der letzten N Stunden ein SIM Swap stattgefunden hat

Aufrufverifizierung

Beide Endpunkte verwenden die HTTP Basic Auth-Authentifizierungsmethode. Fügen Sie Authorization im HTTP-Header hinzu:

              
              Authorization: Basic ${base64_auth_string}

            

Der Generierungsalgorithmus für ${base64_auth_string} lautet: base64(dev_key:dev_secret).

Weitere Details zur Durchführung der API-Authentifizierung finden Sie unter Aufrufverifizierung.

Retrieve Date

Abfrage des Zeitpunkts des letzten SIM Swaps für eine bestimmte Telefonnummer.

Aufrufadresse

POST https://otp.api.engagelab.cc/v1/sim-swap/retrieve-date

Anfragebeispiel

Ein Anfrageobjekt wird im JSON-Format ausgedrückt, daher muss der Anfrage-Header Content-Type: application/json enthalten.

Anfrage-Header

              
              POST /v1/sim-swap/retrieve-date HTTP/1.1
Content-Type: application/json
Authorization: Basic ${base64_auth_string}

            

Anfrage-Body

              
              {
  "phone_number": "+381692223535"
}

            

Anfrageparameter

Antwortparameter

Erfolgsantwort

Beispiel für eine Erfolgsantwort:

              
              {
  "request_id": "2055136570436075520",
  "latest_sim_change": "2026-05-01T15:00:00Z"
}

            

Fehlerantwort

Der HTTP-Statuscode ist 4xx oder 5xx, und der Antwort-Body enthält die folgenden Felder:

Beispiele für häufige Fehlerantworten:

Beispiel für Parameterfehler:

              
              {
  "code": 3002,
  "message": "invalid phone_number"
}

            

Beispiel für unzureichendes Guthaben:

              
              {
  "code": 3005,
  "message": "balance not enough"
}

            

Beispiel für Nummer nicht im Serviceabdeckungsbereich:

              
              {
  "code": 5101,
  "message": "phone number is not in sim swap service coverage"
}

            

Beispiel für allgemeinen Fehler:

              
              {
  "code": 5100,
  "message": "failed to retrieve sim swap date"
}

            

Check

Erkennung, ob für eine bestimmte Telefonnummer innerhalb der letzten N Stunden ein SIM Swap stattgefunden hat.

Aufrufadresse

POST https://otp.api.engagelab.cc/v1/sim-swap/check

Anfragebeispiel

Ein Anfrageobjekt wird im JSON-Format ausgedrückt, und der Anfrage-Header muss ebenfalls Content-Type: application/json enthalten.

Anfrage-Header

              
              POST /v1/sim-swap/check HTTP/1.1
Content-Type: application/json
Authorization: Basic ${base64_auth_string}

            

Anfrage-Body

              
              {
  "phone_number": "+381692223535",
  "max_age": 400
}

            

Anfrageparameter

Antwortparameter

Erfolgsantwort

Beispiel für eine Erfolgsantwort:

              
              {
  "request_id": "2055136570293469184",
  "swapped": true
}

            

Fehlerantwort

Die Struktur ist identisch mit dem Retrieve Date-Endpunkt. Spezifisches Beispiel für eine Fehlerantwort:

Parameterfehler (max_age außerhalb des Bereichs):

              
              {
  "code": 3002,
  "message": "max_age must be between 1 and 2400"
}

            

Fehlercodes