Udviklere

GET/v3/delete_document/{uuid}

Fjern en registreringsprofil

Forstå den destruktive ældre operation, og kontrollér dens begrænsede resultat.

På denne side
  1. Fjern en registreringsprofil med omtanke
  2. Destruktiv anmodning til en ældre operation
  3. Rapporteret resultat
  4. Kontrollér fjernelsen og dens omfang

Fjern en registreringsprofil med omtanke

Denne ældre operation forsøger at slette den identitet og adresse hos teleoperatøren, der tilhører kontoen, og markerer derefter den lokale profil som slettet. Find det korrekte UUID for den lokale profil med documents og gennemgå profilen i portalen inden du kalder operationen. Den fjerner ikke kun dokumentation og er heller ikke en fortrydelsesoperation.

Destruktiv anmodning til en ældre operation

Godkend dig med din aktiverede MultiTEL API-konto fra en tilladt IP-adresse. Eksemplerne bruger legitimationsoplysninger i miljøvariabler og fiktive data. Læs både status.code og status.msg i JSON samt HTTP-svaret.

Den nuværende portal kalder denne operation med GET. Trods HTTP-metoden ændrer den data. Brug aldrig URL'en i et link, et billede, en tilstandskontrol, forhåndshentning i browseren, en crawler eller et automatisk genforsøg. Kræv i din integration, at brugeren udtrykkeligt beslutter at slette.

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

DOCUMENT_UUID er den lokale profils identifikator, som returneres som uuid ved oprettelse eller id ved efterfølgende læsning af profilen. Det er hverken identitetens ID, adressens ID eller et telefonnummer. Der bruges intet anmodningsindhold.

Rapporteret resultat

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

API-koden 404 med meddelelsen Failed, Not found betyder, at profilens UUID ikke blev fundet for denne konto. En rapporteret 200 betyder, at håndteringskoden nåede frem til sit afsluttende svar; det beviser ikke, at teleoperatøren slettede identiteten/adressen, eller at opdateringen af den lokale database lykkedes.

Kontrollér fjernelsen og dens omfang

Den nuværende håndteringskode kontrollerer ikke resultaterne af sletningen hos teleoperatøren eller den lokale opdatering. Når operationen har rapporteret succes, skal du kontrollere, at profilen ikke findes blandt de aktive resultater fra documents og giver svaret ikke fundet fra get_document. Disse kontroller fastslår kun profilens lokale synlighed. De beviser ikke, at der er sket sletning hos en bagvedliggende teleoperatør.

Dette endpoint er ikke et generelt API til sletning af personoplysninger. Det fastslår ikke, at uploadede filer, beviser, understøttende dokumenter, logfiler, sikkerhedskopier eller andre opbevarede oplysninger er slettet. Kontakt support for at få bekræftet fjernelse hos den bagvedliggende teleoperatør eller for at anmode om sletning af data. Kald ikke sletningen gentagne gange som erstatning for at kontrollere et delvist resultat.