Alegeți o referință de încărcare neutilizată
Acest punct de acces elimină o înregistrare a unei referințe de încărcare care aparține contului dumneavoastră. Folosiți-l numai când sunteți sigur că referința nu mai este necesară pentru atașarea unei dovezi sau atașarea unui document justificativ. Nu șterge o identitate sau o adresă din înregistrare.
Obțineți identificatorul extern al fișierului din răspunsul inițial la încărcare sau din lista încărcărilor disponibile. Componenta de procesare caută mai întâi acel identificator pentru contul dumneavoastră, iar ca alternativă folosește identificatorul furnizorului din sistemul vechi. Integrările noi trebuie să folosească referința externă exact în forma returnată. Nu este necesar un corp al cererii.
Solicitați eliminarea în mod intenționat
Folosiți un cont API MultiTEL activat, prin HTTPS, cu datele de autentificare și restricțiile IP configurate pentru acesta. Folosiți POST pentru ca aplicația dumneavoastră să trateze această operație ca pe o modificare intenționată:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefComponenta de procesare actuală nu impune restricții asupra metodei HTTP: și o cerere GET poate declanșa ștergerea. Nu expuneți această adresă URL sub forma unui link obișnuit pe care se poate face clic, a unei imagini, a unui semn de carte sau ca destinație pentru previzualizare ori preîncărcare. Impuneți o acțiune explicită de eliminare în aplicația dumneavoastră și nu reîncercați automat.
Interpretați rezultatul și limitele acestuia
Citiți atât rezultatul HTTP, cât și câmpul status.code din JSON. Răspunsul obișnuit în caz de succes este:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}Codul API 404 însoțit de Failed, Not found înseamnă că niciuna dintre căutări nu a găsit o referință corespunzătoare pentru acest cont. Prin urmare, repetarea eliminării poate returna 404. Spațiile de la începutul și de la sfârșitul valorii din cale sunt eliminate. Aici nu se verifică dacă referința este încă valabilă sau dacă este neutilizată de un alt pas, așa că verificați fluxul de lucru înainte de a o elimina.
Componenta de procesare raportează succesul după ce încearcă ștergerea din baza de date, fără să verifice dacă ștergerea a reușit. Tratați răspunsul ca pe rezultatul raportat, nu ca pe o dovadă independentă a ștergerii. Dacă o referință încă valabilă, creată prin API, era vizibilă în get_encrypted_files, acea listă poate ajuta la verificarea faptului că referința mai este vizibilă, dar absența din listă poate însemna și că a expirat.
Eliminarea nu reprezintă ștergerea completă a datelor
Componenta de procesare lansează o operație de ștergere în tabelul referințelor de încărcare. Nu șterge explicit rândul care conține conținutul documentului stocat, fișierul încărcat local, dovada atașată, identitatea, documentul justificativ sau copia deținută de furnizor. Comportamentul ștergerilor în cascadă din baza de date și cel al păstrării datelor nu au fost verificate. Nu prezentați această operație utilizatorilor ca ștergând toate copiile documentului lor de identitate sau ca îndeplinind o cerere de ștergere integrală a datelor.
După eliminarea referinței locale, pașii ulteriori de atașare care au nevoie de ea pot eșua. Păstrați rezultatele operațiilor de atașare deja finalizate și folosiți fluxul corespunzător de gestionare a identităților sau a dovezilor atunci când modificați informațiile de înregistrare deja trimise.