Verwenden Sie diesen Endpunkt, um zu überprüfen, ob die einer Telefonnummer zugeordnete SIM-Karte innerhalb eines bestimmten Zeitraums ausgetauscht wurde.
Verwandte ID-Mobile-Dokumentation:
GET-Anfrage
https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&licence={LICENCE_CODE}&scope=simswap&period={PERIOD}&name={NAME}Ersetzen Sie die Werte in geschweiften Klammern durch Ihre eigenen Informationen:
| Parameter | Beschreibung | Pflicht/Optional |
|---|---|---|
| SERVER_ADDRESS | Adresse des DQE-Servers, der die Daten verarbeitet. | Pflicht |
| licence | Ihnen als Lizenzcode zugewiesene Nummer. | Pflicht |
| number | Telefonnummer. | Pflicht |
| token | Über die Authentifizierung abgerufenes Token. | Pflicht |
| scope | Statischer Wert. Muss für diesen Scope simswap sein. |
Pflicht |
| period | Vergangener Zeitraum, für den die SIM-Tausch-Prüfung durchgeführt wird. Wert in Stunden. | Pflicht |
| name | Kundenname in der DQE-Datenbank. | Pflicht |
POST-Anfrage
https://{SERVER_ADDRESS}/IDMOBILE/Fügen Sie die folgenden Parameter im Anfragetext mittels x-www-form-urlencoded hinzu:
| Parameter | Beschreibung | Pflicht/Optional |
|---|---|---|
| licence | Ihnen als Lizenzcode zugewiesene Nummer. | Pflicht |
| number | Telefonnummer. | Pflicht |
| token | Über die Authentifizierung abgerufenes Token. | Pflicht |
| scope | Statischer Wert. Muss für diesen Scope simswap sein. |
Pflicht |
| period | Vergangener Zeitraum, für den die SIM-Tausch-Prüfung durchgeführt wird. Wert in Stunden. | Pflicht |
| name | Kundenname in der DQE-Datenbank. | Pflicht |
Antwort
Erfolg
Die API gibt ein JSON-Objekt mit den folgenden Schlüsseln zurück:
| Schlüssel | Beschreibung | Typ |
|---|---|---|
| status | Statusbezeichnung der Anfrage. | STRING |
| operator | Betreiber der Telefonnummer. | STRING |
| swapped | Gibt an, ob die SIM-Karte ausgetauscht wurde: true oder false. |
STRING |
Beispiel:
{
"status": "success",
"operator": "Orange",
"swapped": "false"
}Fehler
Die API gibt ein JSON-Objekt mit den folgenden Schlüsseln zurück:
| Schlüssel | Beschreibung | Typ |
|---|---|---|
| status | error |
STRING |
| error_type | Fehlerbezeichnung. Details finden Sie in der Tabelle unten. | STRING |
| error_id | Fehlercode. Details finden Sie in der Tabelle unten. | STRING(2) |
Details zu den Fehlercodes:
| Fehler-ID | Fehlertyp | Beschreibung |
|---|---|---|
| 01 | invalid request | Die Anfrage ist ungültig. |
| 02 | invalid licence key | Die Lizenz ist ungültig. |
| 04 | invalid scope | Ungültiger Scope. |
| 05 | missing or empty parameter (user_infos) for this scope | Für den angeforderten Scope fehlt ein erforderlicher Parameter. |
| 06 | bad parameter format (user_infos) is not a valid JSON | Der Parameter user_infos ist kein gültiges JSON. |
| 07 | missing mandatory key in user informations (phone) | Der Schlüssel phone ist im Parameter user_infos für diesen Betreiber erforderlich. |
| 09 | ineligible phone number | Die Telefonnummer ist für die Lösung nicht berechtigt. |
| 10 | invalid phone number | Die Telefonnummer existiert nicht. |
| 11 | phone number is empty | Die Telefonnummer ist leer. |
| 12 | phone check failed | Die Betreiberprüfung ist fehlgeschlagen. |
| 13 | operator [Operator Name] not found | Der Betreiber konnte nicht gefunden werden. |
| 14 | operator [Operator Name] not authorized for this licence | Ihre Lizenz ist für diesen Betreiber nicht autorisiert. |
| 15 | operator [Operator Name] not supported yet | Die Lösung ist für diesen Betreiber noch nicht verfügbar. |
| 16 | operator [Operator Name] unreachable | Der Betreiber konnte nicht kontaktiert werden. |
| 17 | scope not supported by this operator [Operator Name] yet | Dieser Scope wird vom Betreiber nicht unterstützt. |
| 30 | invalid or expired token | Das Token ist abgelaufen. |
Beispiel:
{
"status": "error",
"error_type": "invalid phone number",
"error_id": "10"
}