Velg en ubrukt opplastingsreferanse
Dette endepunktet fjerner en oppføring for en opplastingsreferanse som tilhører kontoen din. Bruk det bare når du er sikker på at referansen ikke lenger trengs for tilknytning av dokumentasjon eller tilknytning av et støttedokument. Det sletter ikke en identitet eller adresse som er oppgitt ved registrering.
Hent den eksterne fil-ID-en fra det opprinnelige opplastingssvaret eller listen over tilgjengelige opplastinger. Behandlingsfunksjonen søker først etter denne ID-en for kontoen din og bruker den eldre leverandør-ID-en som reserve dersom den ikke finner noe. Nye integrasjoner bør bruke den eksterne referansen nøyaktig slik den returneres. Det kreves ingen forespørselskropp.
Be om fjerning som en bevisst handling
Bruk en aktivert API-konto hos MultiTEL over HTTPS med de konfigurerte påloggingsopplysningene og IP-begrensningene. Bruk POST slik at applikasjonen behandler dette som en tilsiktet endring:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefDen nåværende behandlingsfunksjonen håndhever ingen begrensning på HTTP-metoden: en GET-forespørsel kan også føre til sletting. Ikke gjør denne URL-en tilgjengelig som en vanlig klikkbar lenke, et bilde, et bokmerke eller et mål for forhåndsvisning eller forhåndshenting. Krev en uttrykkelig handling for fjerning i applikasjonen, og ikke prøv på nytt automatisk.
Tolk resultatet og begrensningene
Les både HTTP-resultatet og status.code i JSON-svaret. Det vanlige svaret ved suksess er:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}API-kode 404 med Failed, Not found betyr at ingen av oppslagene fant en samsvarende referanse for denne kontoen. Gjentatt fjerning kan derfor returnere 404. Innledende og avsluttende mellomrom i stiverdien fjernes. Her kontrolleres det ikke om referansen fortsatt er gyldig eller om den brukes av et annet trinn, så kontroller arbeidsflyten før du fjerner den.
Behandlingsfunksjonen rapporterer suksess etter å ha forsøkt å slette fra databasen, uten å kontrollere om slettingen lyktes. Betrakt svaret som det rapporterte resultatet, ikke som et uavhengig bevis på sletting. Hvis en referanse opprettet via API som ennå ikke var utløpt, var synlig i get_encrypted_files, kan denne listen bidra til å kontrollere om den fortsatt er synlig. At referansen mangler i listen, kan imidlertid også bety at den er utløpt.
Fjerning er ikke fullstendig sletting av data
Behandlingsfunksjonen sender en slettekommando mot tabellen med opplastingsreferanser. Den sletter ikke uttrykkelig den lagrede raden med dokumentinnhold, den lokale opplastede filen, tilknyttet dokumentasjon, identiteten, støttedokumentet eller en kopi som oppbevares hos leverandøren. Virkemåten for kaskadesletting i databasen og oppbevaring av data er ikke verifisert. Ikke presenter denne operasjonen for brukerne som sletting av alle kopier av identitetsdokumentet deres eller som oppfyllelse av en anmodning om fullstendig sletting.
Når den lokale referansen er fjernet, kan senere tilknytningstrinn som trenger den, mislykkes. Behold resultatene av allerede fullførte tilknytninger, og bruk den relevante arbeidsflyten for håndtering av identitet eller dokumentasjon når du endrer innsendte registreringsopplysninger.