Uklonite neiskorištenu referencu na prenesenu datoteku

Odaberite neiskorištenu referencu na prenesenu datoteku

Ova krajnja točka uklanja zapis reference na prenesenu datoteku koji pripada vašem računu. Upotrijebite je samo ako ste sigurni da referenca više nije potrebna za prilaganje dokaza ili prilaganje popratnog dokumenta. Time se ne briše identitet ni adresa za registraciju.

Dohvatite vanjski identifikator datoteke iz izvornog odgovora na prijenos ili popisa dostupnih prenesenih datoteka. Funkcija za obradu zahtjeva prvo traži taj identifikator za vaš račun, a ako ga ne pronađe, koristi stariji identifikator pružatelja usluge kao zamjensku mogućnost. Nove integracije trebaju upotrebljavati vanjsku referencu točno onako kako je vraćena. Tijelo zahtjeva nije potrebno.

Svjesno zatražite uklanjanje

Upotrijebite omogućen račun za MultiTEL API putem protokola HTTPS, s konfiguriranim vjerodajnicama i IP ograničenjima tog računa. Upotrijebite POST kako bi vaša aplikacija ovo tretirala kao namjernu promjenu:

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

Trenutačna funkcija za obradu zahtjeva ne provodi ograničenje metode HTTP: i zahtjev GET može dovesti do brisanja. Nemojte ovaj URL učiniti dostupnim kao običnu poveznicu na koju se može kliknuti, sliku, knjižnu oznaku ili odredište pretpregleda ili prethodnog dohvaćanja. U aplikaciji zahtijevajte izričitu radnju uklanjanja i nemojte automatski ponavljati pokušaj.

Protumačite rezultat i njegova ograničenja

Pročitajte i rezultat HTTP i polje status.code u odgovoru JSON. Uobičajeni odgovor pri uspjehu glasi:

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

Kod 404 za API uz Failed, Not found znači da nijedno od dvaju pretraživanja nije pronašlo odgovarajuću referencu za ovaj račun. Ponovljeno uklanjanje stoga može vratiti 404. Početni i završni razmaci u vrijednosti putanje uklanjaju se. Ovdje se ne provjerava je li referenca još važeća niti koristi li se u nekom drugom koraku, stoga prije uklanjanja provjerite svoj tijek rada.

Funkcija za obradu zahtjeva prijavljuje uspjeh nakon pokušaja brisanja iz baze podataka, bez provjere je li to brisanje uspjelo. Odgovor smatrajte prijavljenim rezultatom, a ne neovisnim dokazom brisanja. Ako je referenca stvorena putem API, kojoj još nije istekao rok valjanosti, bila vidljiva u get_encrypted_files, taj popis može pomoći pri provjeri je li i dalje vidljiva, ali izostanak s popisa može značiti i istek valjanosti.

Uklanjanje nije potpuno brisanje podataka

Funkcija za obradu zahtjeva izdaje naredbu za brisanje u tablici referenci na prenesene datoteke. Ne briše izričito pohranjeni redak sa sadržajem dokumenta, lokalnu prenesenu datoteku, priloženi dokaz, identitet, popratni dokument ni kopiju koju čuva pružatelj usluge. Ponašanje baze podataka pri kaskadnom brisanju i zadržavanju podataka nije provjereno. Nemojte korisnicima ovu radnju predstavljati kao brisanje svih kopija njihova identifikacijskog dokumenta ili kao ispunjavanje zahtjeva za sveobuhvatno brisanje.

Nakon uklanjanja lokalne reference kasniji koraci prilaganja kojima je ona potrebna mogu završiti neuspjehom. Sačuvajte rezultate već dovršenih prilaganja i pri izmjeni predanih registracijskih podataka upotrijebite odgovarajući tijek rada za upravljanje identitetom ili dokazima.