Pašalinkite nebenaudojamą įkėlimo nuorodą

Pasirinkite nebenaudojamą įkėlimo nuorodą

Šis galinis taškas pašalina jūsų paskyrai priklausantį įkėlimo nuorodos įrašą. Naudokite jį tik įsitikinę, kad nuoroda nebereikalinga įrodymui pridėti arba papildomam dokumentui pridėti. Jis neištrina registracijos tapatybės duomenų ar adreso.

Išorinį failo identifikatorių gaukite iš pradinio įkėlimo atsakymo arba prieinamų įkėlimų sąrašo. Apdorojimo procedūra pirmiausia ieško šio identifikatoriaus jūsų paskyroje, o neradusi taiko ankstesnį paieškos pagal teikėjo identifikatorių būdą. Naujos integracijos turėtų naudoti išorinę nuorodą tiksliai tokią, kokia ji grąžinta. Užklausos turinio nereikia.

Šalinimo užklausą siųskite sąmoningai

Naudokite įjungtą MultiTEL API paskyrą per HTTPS, taikydami jai nustatytus prisijungimo duomenis ir IP apribojimus. Naudokite POST, kad jūsų programa šį veiksmą laikytų sąmoningu pakeitimu:

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

Dabartinė apdorojimo procedūra netaiko HTTP metodo apribojimo: GET užklausa taip pat gali sukelti ištrynimą. Nepateikite šio URL kaip įprastos spustelėjamos nuorodos, paveikslėlio, žymelės, peržiūros ar išankstinio įkėlimo adreso. Jūsų programoje reikalaukite aiškaus šalinimo veiksmo ir automatiškai nekartokite užklausos.

Įvertinkite rezultatą ir jo ribotumą

Perskaitykite ir HTTP rezultatą, ir JSON lauką status.code. Įprastas sėkmingas atsakymas yra toks:

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

API kodas 404 su Failed, Not found reiškia, kad nė vienu paieškos būdu nerasta šiai paskyrai priklausančios atitinkamos nuorodos. Todėl pakartotinė šalinimo užklausa gali grąžinti 404. Tarpo ženklai kelio reikšmės pradžioje ir pabaigoje pašalinami. Čia netikrinama, ar nuorodos galiojimas nepasibaigęs arba ar jos nenaudoja kitas veiksmas, todėl prieš ją pašalindami patikrinkite savo darbo eigą.

Apdorojimo procedūra praneša apie sėkmę pabandžiusi ištrinti įrašą duomenų bazėje, tačiau nepatikrina, ar ištrynimas pavyko. Atsakymą laikykite praneštu rezultatu, o ne nepriklausomu ištrynimo įrodymu. Jei per API sukurta nuoroda, kurios galiojimas nepasibaigęs, buvo matoma get_encrypted_files sąraše, šis sąrašas gali padėti patikrinti, ar ji tebėra matoma, tačiau jos nebuvimas sąraše taip pat gali reikšti, kad pasibaigė galiojimas.

Pašalinimas nėra visiškas duomenų ištrynimas

Apdorojimo procedūra siunčia ištrynimo komandą įkėlimo nuorodų lentelei. Ji tiesiogiai neištrina saugomos dokumento turinio eilutės, vietinio įkelto failo, pridėto įrodymo, tapatybės duomenų, papildomo dokumento ar teikėjo saugomos kopijos. Duomenų bazės kaskadinių veiksmų ir duomenų saugojimo elgsena nepatikrinta. Nepristatykite šios operacijos naudotojams kaip visų jų tapatybės dokumento kopijų ištrynimo ar išsamaus prašymo ištrinti duomenis įvykdymo.

Pašalinus vietinę nuorodą, vėlesni pridėjimo veiksmai, kuriems jos reikia, gali nepavykti. Išsaugokite jau atliktų pridėjimo veiksmų rezultatus, o keisdami pateiktą registracijos informaciją naudokite atitinkamą tapatybės duomenų arba įrodymų tvarkymo darbo eigą.