Poista käyttämätön latausviite

Valitse käyttämätön latausviite

Tämä päätepiste poistaa tiliisi kuuluvan latausviitetietueen. Käytä sitä vain, kun olet varma, ettei viitettä enää tarvita seuraaviin tarkoituksiin: todisteen liittäminen tai tukiasiakirjan liittäminen. Se ei poista rekisteröintiin liittyvää henkilöllisyyttä tai osoitetta.

Hae tiedoston ulkoinen tunniste alkuperäisestä lähteestä: latauksen vastaus tai käytettävissä olevien latausten luettelo. Käsittelijä etsii ensin tätä tunnistetta tililtäsi ja käyttää vanhaa palveluntarjoajan tunnistetta varavaihtoehtona. Uusien integraatioiden tulee käyttää ulkoista viitettä täsmälleen palautetussa muodossa. Pyynnön runkoa ei tarvita.

Pyydä poistamista harkitusti

Käytä aktivoitua MultiTEL API -tiliä HTTPS-yhteydellä sekä tilille määritettyjä tunnistetietoja ja IP-rajoituksia. Käytä POST-menetelmää, jotta sovelluksesi käsittelee tämän tarkoituksellisena muutoksena:

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

Nykyinen käsittelijä ei pakota HTTP-menetelmärajoitusta: myös GET-pyyntö voi johtaa poistamiseen. Älä aseta tätä URL-osoitetta tavalliseksi napsautettavaksi linkiksi, kuvaksi, kirjanmerkiksi, esikatselun kohteeksi tai ennakkohaun kohteeksi. Edellytä sovelluksessasi nimenomaista poistotoimintoa äläkä yritä uudelleen automaattisesti.

Tulkitse tulos ja sen rajoitukset

Lue sekä HTTP-tulos että JSON-vastauksen status.code-kenttä. Tavallinen onnistuneen pyynnön vastaus on:

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

API-koodi 404 ja viesti Failed, Not found tarkoittavat, ettei kumpikaan haku löytänyt vastaavaa viitettä tälle tilille. Toistettu poistopyyntö voi siksi palauttaa koodin 404. Polun arvon alussa ja lopussa olevat välilyönnit poistetaan. Tässä ei tarkisteta, onko viite edelleen voimassa tai onko se jonkin muun vaiheen käytössä, joten tarkista työnkulkusi ennen viitteen poistamista.

Käsittelijä ilmoittaa onnistumisesta yritettyään poistaa tietueen tietokannasta tarkistamatta, onnistuiko poisto. Käsittele vastausta ilmoitettuna tuloksena, älä riippumattomana todisteena tietojen hävittämisestä. Jos edelleen voimassa oleva, API-rajapinnan kautta luotu viite näkyi get_encrypted_files-luettelossa, luettelo voi auttaa tarkistamaan, näkyykö viite yhä. Luettelosta puuttuminen voi kuitenkin tarkoittaa myös voimassaolon päättymistä.

Poistaminen ei tarkoita tietojen täydellistä hävittämistä

Käsittelijä suorittaa poistotoiminnon latausviitteiden tauluun. Se ei nimenomaisesti poista tallennettua asiakirjasisällön riviä, paikallista ladattua tiedostoa, liitettyä todistetta, henkilöllisyyttä, tukiasiakirjaa tai palveluntarjoajan hallussa olevaa kopiota. Tietokannan ketjutettujen poistojen ja tietojen säilyttämisen toimintaa ei ole varmistettu. Älä esitä tätä toimintoa käyttäjille kaikkien heidän henkilöllisyysasiakirjansa kopioiden poistamisena tai kattavan tietojen poistopyynnön täyttämisenä.

Kun paikallinen viite on poistettu, sitä tarvitsevat myöhemmät liittämisvaiheet voivat epäonnistua. Säilytä jo suoritettujen liittämisvaiheiden tulokset ja käytä asianmukaista henkilöllisyyden tai todisteiden hallinnan työnkulkua, kun muutat lähetettyjä rekisteröintitietoja.