Eine nicht mehr benötigte Upload-Referenz auswählen
Dieser Endpunkt entfernt einen Datensatz für eine Upload-Referenz, der zu Ihrem Konto gehört. Verwenden Sie ihn nur, wenn Sie sicher sind, dass die Referenz nicht mehr für folgende Vorgänge benötigt wird: Anhängen eines Nachweises oder Anhängen eines ergänzenden Dokuments. Dabei werden weder eine Registrierungsidentität noch eine Adresse gelöscht.
Entnehmen Sie die externe Datei-ID einer der folgenden Quellen: der ursprünglichen Upload-Antwort oder der Liste der verfügbaren Uploads. Die Verarbeitungsroutine sucht zunächst für Ihr Konto nach dieser ID und greift bei Bedarf auf die bisherige Suche anhand der Anbieter-ID zurück. Neue Integrationen sollten die externe Referenz exakt so verwenden, wie sie zurückgegeben wurde. Ein Anfragetext ist nicht erforderlich.
Entfernung bewusst anfordern
Verwenden Sie ein aktiviertes MultiTEL-Konto für die API über HTTPS mit den dafür konfigurierten Zugangsdaten und IP-Beschränkungen. Verwenden Sie POST, damit Ihre Anwendung dies als bewusst vorgenommene Änderung behandelt:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefDie aktuelle Verarbeitungsroutine erzwingt keine Beschränkung der HTTP-Methode: Auch eine GET-Anfrage kann zur Löschung führen. Stellen Sie diese URL nicht als gewöhnlichen anklickbaren Link, als Bild, Lesezeichen, Vorschau oder Ziel für vorab geladene Inhalte bereit. Verlangen Sie in Ihrer Anwendung eine ausdrückliche Aktion zum Entfernen und wiederholen Sie die Anfrage nicht automatisch.
Das Ergebnis und seine Grenzen verstehen
Lesen Sie sowohl das HTTP-Ergebnis als auch im JSON das Feld status.code. Die übliche Antwort bei Erfolg lautet:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Der API-Code 404 mit Failed, Not found bedeutet, dass bei keiner der beiden Suchen eine passende Referenz für dieses Konto gefunden wurde. Eine wiederholte Entfernung kann daher 404 zurückgeben. Führende und nachfolgende Leerzeichen im Pfadwert werden entfernt. Hier wird nicht geprüft, ob die Referenz noch gültig ist oder von einem anderen Schritt nicht mehr benötigt wird. Prüfen Sie daher Ihren Ablauf, bevor Sie die Referenz entfernen.
Die Verarbeitungsroutine meldet nach dem Versuch der Datenbanklöschung Erfolg, ohne zu prüfen, ob die Löschung erfolgreich war. Betrachten Sie die Antwort als gemeldetes Ergebnis und nicht als unabhängigen Nachweis der Löschung. Wenn eine noch gültige, über die API erstellte Referenz in get_encrypted_files sichtbar war, kann diese Liste helfen zu prüfen, ob sie weiterhin sichtbar ist. Fehlt sie in der Liste, kann dies jedoch auch bedeuten, dass sie abgelaufen ist.
Die Entfernung ist keine vollständige Datenlöschung
Die Verarbeitungsroutine führt einen Löschbefehl für die Tabelle der Upload-Referenzen aus. Sie löscht nicht ausdrücklich den gespeicherten Datensatz mit dem Dokumentinhalt, die lokal hochgeladene Datei, den angehängten Nachweis, die Identität, das ergänzende Dokument oder die beim Anbieter gespeicherte Kopie. Das Verhalten bei kaskadierenden Datenbanklöschungen und bei der Datenaufbewahrung wurde nicht überprüft. Stellen Sie diesen Vorgang gegenüber Nutzern nicht als Löschung aller Kopien ihres Identitätsdokuments oder als Erfüllung einer umfassenden Löschanfrage dar.
Sobald die lokale Referenz entfernt wurde, können spätere Schritte zum Anhängen von Dokumenten, die diese Referenz benötigen, fehlschlagen. Bewahren Sie die Ergebnisse bereits abgeschlossener Anhängevorgänge auf und verwenden Sie den entsprechenden Ablauf zur Verwaltung von Identitäten oder Nachweisen, wenn Sie bereits übermittelte Registrierungsdaten ändern.