Verwyder 'n ongebruikte oplaaiverwysing

Kies 'n ongebruikte oplaaiverwysing

Hierdie eindpunt verwyder 'n oplaaiverwysingsrekord wat aan jou rekening behoort. Gebruik dit slegs wanneer jy seker is dat die verwysing nie meer nodig is vir die aanheg van bewysstukke of die aanheg van stawende dokumente nie. Dit verwyder nie 'n registrasie-identiteit of adres nie.

Kry die eksterne lêer-ID uit die oorspronklike oplaaiantwoord of lys van beskikbare oplaaie. Die hanteerder soek eers daardie ID vir jou rekening op en val terug op 'n ou verskaffer-ID as dit nie gevind word nie. Nuwe integrasies moet die eksterne verwysing presies gebruik soos dit teruggestuur is. Geen versoekliggaam word vereis nie.

Versoek verwydering doelbewus

Gebruik 'n geaktiveerde MultiTEL-API-rekening oor HTTPS met die aanmeldbesonderhede en IP-beperkings wat daarvoor opgestel is. Gebruik POST sodat jou toepassing dit as 'n doelbewuste verandering hanteer:

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

Die huidige hanteerder dwing nie 'n beperking op die HTTP-metode af nie: 'n GET-versoek kan ook tot verwydering lei. Moenie hierdie URL as 'n gewone klikbare skakel, beeld, boekmerk, voorskou of teiken vir vooraflaai beskikbaar stel nie. Vereis 'n uitdruklike verwyderingshandeling in jou toepassing, en moenie outomaties weer probeer nie.

Verstaan die resultaat en die beperkings daarvan

Lees sowel die HTTP-resultaat as die status.code-veld in die JSON-antwoord. Die gewone suksesvolle antwoord is:

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

Die API-kode 404 met Failed, Not found beteken dat nie een van die twee soektogte 'n ooreenstemmende verwysing vir hierdie rekening gevind het nie. 'n Herhaalde verwyderingsversoek kan dus 404 terugstuur. Spasies aan die begin en einde van die padwaarde word verwyder. Hier word nie nagegaan of die verwysing nog nie verval het nie of of dit nie deur 'n ander stap gebruik word nie; maak dus seker van jou werkvloei voordat jy dit verwyder.

Die hanteerder meld sukses nadat dit probeer het om die rekord uit die databasis te verwyder, sonder om na te gaan of die verwydering geslaag het. Hanteer die antwoord as die gerapporteerde resultaat, nie as onafhanklike bewys van uitwissing nie. As 'n verwysing wat deur die API geskep is en nog nie verval het nie, in get_encrypted_files sigbaar was, kan daardie lys help om na te gaan of dit steeds sigbaar is, maar afwesigheid uit die lys kan ook beteken dat dit verval het.

Verwydering is nie volledige data-uitwissing nie

Die hanteerder voer 'n verwyderingsopdrag op die oplaaiverwysingstabel uit. Dit verwyder nie uitdruklik die gestoorde ry met dokumentinhoud, die plaaslike opgelaaide lêer, die aangehegte bewysstuk, die identiteit, die stawende dokument of die kopie wat die verskaffer hou nie. Die databasis se gedrag ten opsigte van kaskadeverwydering en bewaring is nie geverifieer nie. Moenie hierdie bewerking aan gebruikers voorstel asof dit alle kopieë van hul identiteitsdokument verwyder of aan 'n versoek om omvattende uitwissing voldoen nie.

Sodra die plaaslike verwysing verwyder is, kan latere aanhegtingstappe wat dit nodig het, misluk. Behou die resultate van aanhegtings wat reeds voltooi is, en gebruik die toepaslike werkvloei vir die bestuur van identiteite of bewysstukke wanneer jy ingediende registrasie-inligting verander.