Zgjidhni një referencë ngarkimi të papërdorur
Kjo pikë fundore heq një regjistrim të referencës së ngarkimit që i përket llogarisë suaj. Përdoreni vetëm kur jeni të sigurt se referenca nuk nevojitet më për bashkëngjitjen e një dëshmie ose bashkëngjitjen e një dokumenti mbështetës. Ajo nuk fshin një identitet ose adresë të regjistrimit.
Merrni identifikuesin e jashtëm të skedarit nga përgjigjja fillestare e ngarkimit ose nga lista e ngarkimeve të disponueshme. Komponenti përpunues fillimisht kërkon atë identifikues për llogarinë tuaj dhe, si alternativë, përdor identifikuesin e ofruesit nga sistemi i vjetër. Integrimet e reja duhet ta përdorin referencën e jashtme pikërisht siç kthehet. Nuk kërkohet trup kërkese.
Kërkojeni heqjen me qëllim të qartë
Përdorni një llogari API MultiTEL të aktivizuar përmes HTTPS, me kredencialet dhe kufizimet IP të konfiguruara për të. Përdorni POST që aplikacioni juaj ta trajtojë këtë si një ndryshim të qëllimshëm:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefKomponenti përpunues aktual nuk zbaton kufizim për metodën HTTP: edhe një kërkesë GET mund të shkaktojë fshirjen. Mos e ekspozoni këtë URL si një lidhje të zakonshme të klikueshme, imazh, faqeshënues ose destinacion për parapamje apo ngarkim paraprak. Kërkoni një veprim të qartë heqjeje në aplikacionin tuaj dhe mos e riprovoni automatikisht.
Interpretoni rezultatin dhe kufizimet e tij
Lexoni si rezultatin HTTP, ashtu edhe fushën status.code në JSON. Përgjigjja e zakonshme kur veprimi kryhet me sukses është:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Kodi API 404 me Failed, Not found do të thotë se asnjëri nga kërkimet nuk gjeti një referencë përkatëse për këtë llogari. Prandaj, një heqje e përsëritur mund të kthejë 404. Hapësirat në fillim dhe në fund të vlerës së shtegut hiqen. Këtu nuk kontrollohet nëse referenca është ende e vlefshme ose nëse nuk përdoret nga një hap tjetër, ndaj verifikoni rrjedhën tuaj të punës përpara se ta hiqni.
Komponenti përpunues raporton sukses pasi përpiqet të kryejë fshirjen nga baza e të dhënave, pa kontrolluar nëse ajo fshirje pati sukses. Trajtojeni përgjigjen si rezultatin e raportuar, jo si provë të pavarur të fshirjes. Nëse një referencë ende e vlefshme, e krijuar përmes API, ishte e dukshme në get_encrypted_files, ajo listë mund të ndihmojë për të kontrolluar nëse referenca mbetet e dukshme, por mungesa nga lista mund të nënkuptojë edhe skadimin e saj.
Heqja nuk është fshirje e plotë e të dhënave
Komponenti përpunues lëshon një komandë fshirjeje në tabelën e referencave të ngarkimit. Ai nuk fshin shprehimisht rreshtin e ruajtur me përmbajtjen e dokumentit, skedarin e ngarkuar lokalisht, dëshminë e bashkëngjitur, identitetin, dokumentin mbështetës ose kopjen që mban ofruesi. Sjellja e fshirjeve zinxhir në bazën e të dhënave dhe e ruajtjes së të dhënave nuk është verifikuar. Mos ua paraqitni përdoruesve këtë veprim sikur fshin të gjitha kopjet e dokumentit të tyre të identitetit ose përmbush një kërkesë për fshirje të plotë të të dhënave.
Pasi të hiqet referenca lokale, hapat e mëvonshëm të bashkëngjitjes që kanë nevojë për të mund të dështojnë. Ruani rezultatet e bashkëngjitjeve tashmë të përfunduara dhe përdorni rrjedhën përkatëse të punës për menaxhimin e identitetit ose të dëshmive kur ndryshoni informacionin e regjistrimit që është dorëzuar.