Izvēlieties neizmantotu augšupielādes atsauci
Šis galapunkts dzēš jūsu kontam piederošu augšupielādes atsauces ierakstu. Izmantojiet to tikai tad, ja esat pārliecināts, ka atsauce vairs nav vajadzīga šīm darbībām: apliecinājuma pievienošana vai papildu dokumenta pievienošana. Tas nedzēš reģistrācijas identitāti vai adresi.
Iegūstiet ārējo faila identifikatoru no sākotnējās augšupielādes datiem: augšupielādes atbildes vai pieejamo augšupielāžu saraksta. Apstrādātājs vispirms meklē šo identifikatoru jūsu kontā; ja tas netiek atrasts, kā rezerves iespēja tiek izmantota meklēšana pēc mantotā pakalpojuma sniedzēja identifikatora. Jaunās integrācijās ārējā atsauce jāizmanto tieši tādā veidā, kādā tā atgriezta. Pieprasījuma pamatteksts nav nepieciešams.
Pieprasiet dzēšanu apzināti
Izmantojiet iespējotu MultiTEL API kontu ar tā konfigurētajiem piekļuves datiem un IP ierobežojumiem, savienojumu veidojot ar HTTPS. Izmantojiet POST, lai jūsu lietotne šo darbību uztvertu kā apzinātu izmaiņu:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdefPašreizējais apstrādātājs nepiemēro HTTP metodes ierobežojumu: arī GET pieprasījums var izraisīt dzēšanu. Nepadariet šo URL pieejamu kā parastu klikšķināmu saiti, attēlu, grāmatzīmi, priekšskatījuma vai priekšielādes mērķi. Savā lietotnē pieprasiet skaidri izteiktu dzēšanas darbību un neatkārtojiet pieprasījumu automātiski.
Izvērtējiet rezultātu un tā ierobežojumus
Pārbaudiet gan HTTP rezultātu, gan JSON lauku status.code. Parastā veiksmīgā atbilde ir šāda:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}API kods 404 ar ziņojumu Failed, Not found nozīmē, ka nevienā no abiem meklējumiem šim kontam netika atrasta atbilstoša atsauce. Tāpēc atkārtots dzēšanas pieprasījums var atgriezt 404. Atstarpes ceļa vērtības sākumā un beigās tiek noņemtas. Šeit netiek pārbaudīts, vai atsauces derīguma termiņš nav beidzies un vai to neizmanto kāds cits solis, tāpēc pirms tās dzēšanas pārbaudiet savu darbplūsmu.
Pēc mēģinājuma veikt dzēšanu datubāzē apstrādātājs ziņo par panākumiem, nepārbaudot, vai dzēšana ir izdevusies. Uztveriet atbildi kā paziņoto rezultātu, nevis neatkarīgu dzēšanas apliecinājumu. Ja ar API izveidota atsauce, kuras derīguma termiņš vēl nav beidzies, bija redzama get_encrypted_files sarakstā, šis saraksts var palīdzēt pārbaudīt, vai tā joprojām ir redzama, taču tās neesamība sarakstā var nozīmēt arī derīguma termiņa beigas.
Dzēšana nenozīmē pilnīgu datu dzēšanu
Apstrādātājs izpilda dzēšanas komandu augšupielādes atsauču tabulā. Tas neveic tiešu saglabātās dokumenta satura rindas, lokālā augšupielādētā faila, pievienotā apliecinājuma, identitātes, papildu dokumenta vai pie pakalpojuma sniedzēja esošās kopijas dzēšanu. Datubāzes kaskādes darbību un datu glabāšanas uzvedība nav pārbaudīta. Nepasniedziet šo darbību lietotājiem kā visu viņu personu apliecinošā dokumenta kopiju dzēšanu vai visaptveroša dzēšanas pieprasījuma izpildi.
Pēc lokālās atsauces dzēšanas turpmākie pievienošanas soļi, kuriem tā nepieciešama, var neizdoties. Saglabājiet jau pabeigto pievienošanas darbību rezultātus un, mainot iesniegto reģistrācijas informāciju, izmantojiet attiecīgo identitātes vai apliecinājuma pārvaldības darbplūsmu.