Een ongebruikte uploadverwijzing verwijderen

Kies een ongebruikte uploadverwijzing

Dit eindpunt verwijdert een uploadverwijzingsrecord dat bij uw account hoort. Gebruik het alleen als u zeker weet dat de verwijzing niet meer nodig is voor het bijvoegen van een bewijsstuk of het bijvoegen van een ondersteunend document. Het verwijdert geen identiteitsgegevens of adres voor een registratie.

Haal de externe bestands-ID uit de oorspronkelijke bron: het uploadantwoord of de lijst met beschikbare uploads. De verwerkingsroutine zoekt die ID eerst op voor uw account en valt zo nodig terug op de oude zoekmethode via de provider-ID. Nieuwe integraties moeten de externe verwijzing exact gebruiken zoals die is teruggegeven. Een aanvraagbody is niet vereist.

Vraag verwijdering bewust aan

Gebruik een geactiveerd MultiTEL API-account via HTTPS, met de daarvoor ingestelde inloggegevens en IP-beperkingen. Gebruik POST zodat uw toepassing dit als een bewuste wijziging behandelt:

curl --silent --show-error --request POST \
  --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef

De huidige verwerkingsroutine dwingt geen beperking op de HTTP-methode af: ook een GET-aanvraag kan tot verwijdering leiden. Maak deze URL niet beschikbaar als gewone klikbare link, afbeelding, bladwijzer of doel voor een voorvertoning of vooraf ophalen. Vereis een expliciete verwijderactie in uw toepassing en probeer de aanvraag niet automatisch opnieuw.

Beoordeel het resultaat en de beperkingen ervan

Controleer zowel het HTTP-resultaat als het veld status.code in JSON. Het gebruikelijke antwoord bij succes is:

{
  "status": {"code": 200, "msg": "Success"},
  "response": []
}

API-code 404 met Failed, Not found betekent dat geen van beide zoekmethoden een overeenkomende verwijzing voor dit account heeft gevonden. Een herhaalde verwijderaanvraag kan daarom 404 opleveren. Spaties aan het begin en einde van de padwaarde worden verwijderd. Er wordt hier niet gecontroleerd of de verwijzing nog geldig is of ongebruikt is door een andere stap. Controleer daarom vóór verwijdering of uw proces dit toelaat.

De verwerkingsroutine meldt succes na een poging tot verwijdering uit de database, zonder te controleren of die verwijdering is geslaagd. Beschouw het antwoord als het gemelde resultaat, niet als onafhankelijk bewijs dat de gegevens zijn gewist. Als een via de API aangemaakte verwijzing die nog niet was verlopen zichtbaar was in get_encrypted_files, kan die lijst helpen controleren of de verwijzing nog zichtbaar is. Afwezigheid in de lijst kan echter ook betekenen dat de verwijzing is verlopen.

Verwijderen betekent niet dat alle gegevens worden gewist

De verwerkingsroutine voert een verwijderopdracht uit op de tabel met uploadverwijzingen. Deze verwijdert niet expliciet de opgeslagen rij met documentinhoud, het lokaal geüploade bestand, het bijgevoegde bewijsstuk, de identiteitsgegevens, het ondersteunende document of de kopie bij de provider. Het gedrag van trapsgewijze verwijdering in de database en van gegevensbewaring is niet geverifieerd. Presenteer deze handeling niet aan gebruikers als het verwijderen van alle kopieën van hun identiteitsdocument of als het voldoen aan een verzoek om volledige gegevenswissing.

Zodra de lokale verwijzing is verwijderd, kunnen latere stappen voor het bijvoegen van documenten die deze verwijzing nodig hebben mislukken. Bewaar de resultaten van reeds voltooide bijvoegstappen en gebruik het toepasselijke proces voor het beheren van identiteitsgegevens of bewijsstukken wanneer u ingediende registratiegegevens wijzigt.