Vývojáři

GET/v3/delete_document/{uuid}

Odstranění registračního profilu

Seznamte se s destruktivní operací staršího rozhraní a ověřte její omezený výsledek.

Na této stránce
  1. Registrační profil odstraňujte uváženě
  2. Destruktivní požadavek staršího rozhraní
  3. Ohlášený výsledek
  4. Ověřte odstranění a jeho rozsah

Registrační profil odstraňujte uváženě

Tato operace staršího rozhraní se pokusí u operátora odstranit identitu a adresu patřící účtu a poté označí místní profil jako odstraněný. Správné UUID místního profilu zjistěte pomocí documents a před voláním operace profil zkontrolujte na portálu. Nejde o odstranění samotného dokladu ani o operaci vrácení změn.

Destruktivní požadavek staršího rozhraní

Ověřte se pomocí svého aktivovaného účtu pro MultiTEL API z povolené IP adresy. Příklady používají přihlašovací údaje v proměnných prostředí a smyšlená data. Kromě odpovědi HTTP zkontrolujte také pole status.code a status.msg v JSON.

Současný portál volá tuto operaci metodou GET. Navzdory použité metodě HTTP tato operace mění data. Nikdy tuto URL nepoužívejte v odkazu, obrázku, kontrole dostupnosti, předběžném načítání prohlížeče, prohledávacím robotu ani při automatickém opakování požadavku. Ve své integraci vyžadujte výslovné rozhodnutí uživatele o odstranění.

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

DOCUMENT_UUID je identifikátor místního profilu vrácený jako uuid při vytvoření nebo jako id při následném načtení profilu. Nejde o ID identity, ID adresy ani telefonní číslo. Tělo požadavku se nepoužívá.

Ohlášený výsledek

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

Kód API 404 se zprávou Failed, Not found znamená, že UUID profilu nebylo pro tento účet nalezeno. Ohlášený kód 200 znamená, že obslužný kód dospěl k odeslání závěrečné odpovědi; nedokazuje, že operátor odstranil identitu/adresu ani že aktualizace místní databáze proběhla úspěšně.

Ověřte odstranění a jeho rozsah

Současný obslužný kód nekontroluje výsledky odstranění u operátora ani místní aktualizace. Po ohlášeném úspěchu ověřte, že profil chybí ve výsledcích aktivních profilů z documents a že je při volání get_document hlášen jako nenalezený. Tyto kontroly ověřují pouze místní viditelnost. Nedokazují odstranění u nadřazeného operátora.

Tento koncový bod není obecným API pro výmaz osobních údajů. Nepotvrzuje odstranění nahraných souborů, dokladů, podpůrných dokumentů, protokolů, záloh ani jiných uchovávaných záznamů. Pokud potřebujete potvrzené odstranění u nadřazeného operátora nebo chcete požádat o výmaz údajů, obraťte se na podporu. Nenahrazujte ověření částečného výsledku opakovaným voláním odstranění.