Ein Registrierungsprofil bewusst entfernen
Dieser Legacy-Vorgang versucht, die dem Konto zugeordnete Identität und Adresse beim Netzbetreiber zu löschen, und markiert anschließend das lokale Profil als gelöscht. Ermitteln Sie die richtige UUID des lokalen Profils mit documents und überprüfen Sie das Profil im Portal, bevor Sie den Vorgang aufrufen. Dabei werden weder ausschließlich Nachweise entfernt noch wird eine vorherige Aktion rückgängig gemacht.
Destruktive Legacy-Anfrage
Authentifizieren Sie sich von einer zulässigen IP-Adresse aus mit Ihrem freigeschalteten MultiTEL-API-Konto. Die Beispiele verwenden Zugangsdaten aus Umgebungsvariablen und fiktive Daten. Lesen Sie neben der HTTP-Antwort auch die JSON-Felder status.code und status.msg.
Das aktuelle Portal ruft diesen Vorgang mit GET auf. Trotz dieser HTTP-Methode verändert der Vorgang Daten. Verwenden Sie die URL niemals in einem Link, einem Bild, einer Zustandsprüfung, beim Vorabladen durch den Browser, in einem Crawler oder bei einem automatischen Wiederholungsversuch. Setzen Sie in Ihrer Integration eine ausdrückliche Löschentscheidung des Benutzers voraus.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"DOCUMENT_UUID ist die Kennung des lokalen Profils, die beim Erstellen als uuid oder beim Auslesen des Profils als id zurückgegeben wird. Sie ist weder die Identitäts-ID noch die Adress-ID oder eine Telefonnummer. Es wird kein Anfragekörper verwendet.
Gemeldetes Ergebnis
{
"status": {
"code": 200,
"msg": "Success"
},
"response": []
}Der API-Code 404 mit der Meldung Failed, Not found bedeutet, dass die Profil-UUID für dieses Konto nicht gefunden wurde. Ein gemeldeter Code 200 bedeutet, dass der Handler seine abschließende Antwort erreicht hat; er beweist weder, dass der Netzbetreiber die Identität und Adresse gelöscht hat, noch, dass die Aktualisierung der lokalen Datenbank erfolgreich war.
Entfernung und deren Umfang überprüfen
Der aktuelle Handler überprüft weder die Ergebnisse der Löschung beim Netzbetreiber noch die der lokalen Aktualisierung. Vergewissern Sie sich nach einer gemeldeten erfolgreichen Ausführung, dass das Profil in den aktiven Ergebnissen von documents nicht enthalten ist und beim Abruf über get_document als nicht gefunden gemeldet wird. Diese Prüfungen geben ausschließlich Auskunft über die lokale Sichtbarkeit. Sie beweisen keine Löschung bei einem vorgelagerten Netzbetreiber.
Dieser Endpunkt ist keine allgemeine API zur Löschung personenbezogener Daten. Er belegt keine Löschung hochgeladener Dateien, Nachweise, ergänzender Dokumente, Protokolle, Sicherungskopien oder anderer aufbewahrter Datensätze. Wenden Sie sich an den Support, wenn Sie eine bestätigte Löschung beim vorgelagerten Anbieter benötigen oder die Löschung Ihrer Daten beantragen möchten. Rufen Sie die Löschfunktion nicht wiederholt auf, anstatt ein Teilergebnis zu überprüfen.