Poista rekisteröintiprofiili

Poista rekisteröintiprofiili harkitusti

Tämä vanha toiminto yrittää poistaa tilille kuuluvan henkilöllisyyden ja osoitteen operaattorin järjestelmästä ja merkitsee sitten paikallisen profiilin poistetuksi. Selvitä oikean paikallisen profiilin UUID-tunniste toiminnolla documents ja tarkista profiili portaalissa ennen toiminnon kutsumista. Toiminto ei poista pelkästään todistetta eikä kumoa aiempaa toimintoa.

Tietoja poistava vanha pyyntö

Tunnistaudu käyttöön otetulla MultiTEL API -tililläsi sallitusta IP-osoitteesta. Esimerkeissä käytetään ympäristömuuttujiin tallennettuja tunnuksia ja kuvitteellisia tietoja. Lue HTTP-vastauksen lisäksi JSON-kentät status.code ja status.msg.

Nykyinen portaali kutsuu tätä toimintoa GET-menetelmällä. HTTP-menetelmästä huolimatta toiminto muuttaa tietoja. Älä koskaan käytä URL-osoitetta linkissä, kuvassa, toimintakunnon tarkistuksessa, selaimen esihaussa, indeksointirobotissa tai automaattisessa uudelleenyrityksessä. Edellytä integraatiossasi käyttäjän nimenomaista päätöstä poistamisesta.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"

DOCUMENT_UUID on paikallisen profiilin tunniste, joka palautetaan luonnin yhteydessä kentässä uuid tai profiilin tietoja luettaessa kentässä id. Se ei ole henkilöllisyyden tunniste, osoitteen tunniste eikä puhelinnumero. Pyynnössä ei käytetä runkoa.

Ilmoitettu tulos

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

API-koodi 404 ja viesti Failed, Not found tarkoittavat, ettei profiilin UUID-tunnistetta löytynyt tältä tililtä. Ilmoitettu 200 tarkoittaa, että käsittelijä eteni loppuvastaukseensa asti; se ei todista, että operaattori poisti henkilöllisyyden ja osoitteen tai että paikallisen tietokannan päivitys onnistui.

Varmista poisto ja sen laajuus

Nykyinen käsittelijä ei tarkista operaattorin järjestelmässä tehtävän poiston eikä paikallisen päivityksen tuloksia. Kun toiminto on ilmoittanut onnistumisesta, varmista, ettei profiilia ole aktiivisten documents-tulosten joukossa ja että profiilia haettaessa saadaan tieto, ettei sitä löytynyt, toiminnosta get_document. Nämä tarkistukset osoittavat vain profiilin paikallisen näkyvyyden. Ne eivät todista, että profiili olisi poistettu taustalla toimivan operaattorin järjestelmästä.

Tämä rajapinnan päätepiste ei ole yleinen henkilötietojen poistamiseen tarkoitettu API. Se ei osoita, että ladatut tiedostot, todisteet, täydentävät asiakirjat, lokit, varmuuskopiot tai muut säilytetyt tietueet olisi poistettu. Ota yhteyttä tukeen, jos tarvitset vahvistuksen poistosta taustalla toimivan operaattorin järjestelmästä tai haluat pyytää tietojen poistamista. Älä kutsu poistotoimintoa toistuvasti sen sijaan, että tarkistaisit osittaisen tuloksen.