Kustutage kasutamata üleslaadimisviide

Valige kasutamata üleslaadimisviide

See otspunkt kustutab teie kontole kuuluva üleslaadimisviite kirje. Kasutage seda ainult siis, kui olete kindel, et viidet ei ole enam vaja järgmisteks toiminguteks: tõendi lisamine või lisadokumendi lisamine. See ei kustuta registreerimise identiteeti ega aadressi.

Hankige faili väline identifikaator algse üleslaadimise andmetest: üleslaadimise vastusest või saadaolevate üleslaadimiste loendist. Töötleja otsib esmalt seda identifikaatorit teie konto alt; kui vastet ei leita, kasutatakse varuvariandina otsingut teenusepakkuja pärandidentifikaatori järgi. Uued integratsioonid peaksid kasutama välist viidet täpselt tagastatud kujul. Päringu sisu ei ole vaja.

Taotlege kustutamist teadlikult

Kasutage lubatud MultiTEL API kontot selle seadistatud autentimisandmete ja IP-piirangutega ning looge ühendus protokolli HTTPS kaudu. Kasutage meetodit POST, et teie rakendus käsitleks seda teadliku muudatusena:

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

Praegune töötleja ei jõusta HTTP meetodi piirangut: ka GET päring võib käivitada kustutamise. Ärge tehke seda URL-i kättesaadavaks tavalise klõpsatava lingi, pildi, järjehoidja, eelvaate ega eellaadimise sihtmärgina. Nõudke oma rakenduses selgesõnalist kustutamistoimingut ja ärge korrake päringut automaatselt.

Tõlgendage tulemust ja selle piiranguid

Kontrollige nii HTTP tulemust kui ka JSON välja status.code. Tavaline eduka päringu vastus on järgmine:

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

API kood 404 koos teatega Failed, Not found tähendab, et kumbki otsing ei leidnud sellele kontole vastavat viidet. Seetõttu võib korduv kustutamispäring tagastada koodi 404. Tee väärtuse algusest ja lõpust eemaldatakse tühikud. Siin ei kontrollita, kas viide on aegumata ega seda, kas mõni muu etapp seda kasutab, seega kontrollige enne viite kustutamist oma töövoogu.

Töötleja teatab pärast andmebaasist kustutamise katset õnnestumisest, kontrollimata, kas kustutamine õnnestus. Käsitlege vastust teatatud tulemusena, mitte kustutamise sõltumatu tõendina. Kui API kaudu loodud aegumata viide oli loendis get_encrypted_files nähtav, võib see loend aidata kontrollida, kas viide on endiselt nähtav, kuid loendist puudumine võib tähendada ka aegumist.

Kustutamine ei tähenda andmete täielikku kustutamist

Töötleja väljastab üleslaadimisviidete tabelile kustutamiskäsu. See ei kustuta otseselt salvestatud dokumendisisu rida, kohalikku üleslaaditud faili, lisatud tõendit, identiteeti, lisadokumenti ega teenusepakkuja valduses olevat koopiat. Andmebaasi kaskaadtoimingute ja andmete säilitamise käitumist ei ole kontrollitud. Ärge esitlege seda toimingut kasutajatele kõigi nende isikut tõendava dokumendi koopiate kustutamisena ega kõikehõlmava kustutamistaotluse täitmisena.

Pärast kohaliku viite kustutamist võivad hilisemad lisamisetapid, mis seda vajavad, ebaõnnestuda. Säilitage juba lõpetatud lisamistoimingute tulemused ja kasutage esitatud registreerimisandmete muutmisel asjakohast identiteedi või tõendi haldamise töövoogu.