Ta bort en oanvänd uppladdningsreferens

Välj en oanvänd uppladdningsreferens

Den här slutpunkten tar bort en post för en uppladdningsreferens som tillhör ditt konto. Använd den bara när du är säker på att referensen inte längre behövs för bifogande av intyg eller bifogande av kompletterande dokument. Den tar inte bort någon registreringsidentitet eller adress.

Hämta det externa fil-ID:t från det ursprungliga uppladdningssvaret eller listan över tillgängliga uppladdningar. Hanteraren söker först efter detta ID för ditt konto och använder ett äldre leverantörs-ID som reservalternativ. Nya integrationer bör använda den externa referensen exakt som den returneras. Ingen meddelandekropp krävs i begäran.

Begär borttagning som en medveten åtgärd

Använd ett aktiverat MultiTEL API-konto via HTTPS med kontots konfigurerade inloggningsuppgifter och IP-begränsningar. Använd POST så att din applikation behandlar detta som en avsiktlig ändring:

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

Den nuvarande hanteraren upprätthåller ingen begränsning av HTTP-metoder: även en GET-begäran kan leda till borttagning. Gör inte denna URL tillgänglig som en vanlig klickbar länk, bild, bokmärke eller som mål för förhandsvisning eller förhandshämtning. Kräv en uttrycklig borttagningsåtgärd i din applikation och gör inga automatiska återförsök.

Tolka resultatet och dess begränsningar

Läs både HTTP-resultatet och fältet status.code i JSON-svaret. Det normala svaret vid en lyckad begäran är:

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

API-koden 404 med Failed, Not found betyder att ingen av sökningarna hittade en matchande referens för det här kontot. En upprepad borttagning kan därför returnera 404. Inledande och avslutande blanksteg i sökvägsvärdet tas bort. Här kontrolleras inte att referensen fortfarande är giltig eller att den inte används av ett annat steg, så kontrollera ditt arbetsflöde innan du tar bort den.

Hanteraren rapporterar att åtgärden lyckades efter att ha försökt utföra borttagningen i databasen, utan att kontrollera om borttagningen lyckades. Betrakta svaret som det rapporterade resultatet, inte som ett oberoende bevis på radering. Om en fortfarande giltig referens som skapats via API var synlig i get_encrypted_files, kan den listan hjälpa dig att kontrollera om referensen fortfarande är synlig, men att den saknas i listan kan också betyda att giltighetstiden har löpt ut.

Borttagning innebär inte fullständig dataradering

Hanteraren utför en borttagningsåtgärd i tabellen för uppladdningsreferenser. Den tar inte uttryckligen bort den lagrade raden med dokumentinnehåll, den lokalt uppladdade filen, det bifogade intyget, identiteten, det kompletterande dokumentet eller den kopia som leverantören har. Databasens beteende vid kaskadborttagning och datalagring har inte verifierats. Beskriv inte den här åtgärden för användarna som att den raderar alla kopior av deras identitetshandling eller uppfyller en begäran om fullständig radering.

När den lokala referensen har tagits bort kan senare steg för att bifoga dokument misslyckas om de behöver referensen. Spara resultaten från redan slutförda bifogningssteg och använd det relevanta arbetsflödet för hantering av identiteter eller intyg när du ändrar inskickade registreringsuppgifter.