Fjern en ubrugt uploadreference

Vælg en ubrugt uploadreference

Dette endepunkt fjerner en post med en uploadreference, som tilhører din konto. Brug det kun, når du er sikker på, at referencen ikke længere er nødvendig til vedhæftning af dokumentation eller vedhæftning af et supplerende dokument. Det sletter ikke en registreringsidentitet eller en adresse.

Hent det eksterne fil-id fra det oprindelige uploadsvar eller listen over tilgængelige uploads. Behandlingsfunktionen søger først efter dette id for din konto og bruger et ældre udbyder-id som alternativ, hvis det første opslag ikke giver et resultat. Nye integrationer bør bruge den eksterne reference præcis, som den returneres. Der kræves intet anmodningsindhold.

Anmod bevidst om fjernelse

Brug en aktiveret MultiTEL API-konto via HTTPS med kontoens konfigurerede legitimationsoplysninger og IP-begrænsninger. Brug POST, så din applikation behandler dette som en bevidst ændring:

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

Den nuværende behandlingsfunktion håndhæver ingen begrænsning af HTTP-metoden: En GET-anmodning kan også udløse sletning. Gør ikke denne URL tilgængelig som et almindeligt klikbart link, et billede, et bogmærke eller et mål for forhåndsvisning eller forhåndshentning. Kræv en udtrykkelig fjernelseshandling i din applikation, og gentag ikke forsøget automatisk.

Fortolk resultatet og dets begrænsninger

Læs både HTTP-resultatet og feltet status.code i JSON-svaret. Det normale svar ved succes er:

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

API-kode 404 med Failed, Not found betyder, at ingen af de to opslag fandt en tilsvarende reference for denne konto. En gentagen fjernelse kan derfor returnere 404. Indledende og afsluttende mellemrum i stiværdien fjernes. Her kontrolleres det ikke, om referencen stadig er gyldig eller ikke bruges af et andet trin, så kontrollér din arbejdsgang, før du fjerner den.

Behandlingsfunktionen melder succes efter at have forsøgt at slette i databasen uden at kontrollere, om sletningen lykkedes. Betragt svaret som det rapporterede resultat, ikke som et uafhængigt bevis på sletning. Hvis en reference, der var oprettet via API og endnu ikke var udløbet, var synlig i get_encrypted_files, kan denne liste hjælpe med at kontrollere, om den stadig er synlig, men fravær fra listen kan også betyde, at den er udløbet.

Fjernelse er ikke fuldstændig sletning af data

Behandlingsfunktionen udfører en slettekommando på tabellen med uploadreferencer. Den sletter ikke udtrykkeligt den gemte række med dokumentindhold, den lokalt uploadede fil, den vedhæftede dokumentation, identiteten, det supplerende dokument eller den kopi, som udbyderen opbevarer. Databasens adfærd ved kaskadesletning og opbevaring er ikke blevet verificeret. Fremstil ikke denne handling over for brugerne som en sletning af alle kopier af deres identitetsdokument eller som opfyldelse af en anmodning om omfattende sletning.

Når den lokale reference er fjernet, kan senere vedhæftningstrin, som har brug for den, mislykkes. Bevar resultaterne af allerede gennemførte vedhæftninger, og brug den relevante arbejdsgang til administration af identitet eller dokumentation, når du ændrer indsendte registreringsoplysninger.