Odstranění nepoužívaného odkazu na nahraný soubor

Vyberte nepoužívaný odkaz na nahraný soubor

Tento koncový bod odstraní záznam odkazu na nahraný soubor, který patří vašemu účtu. Použijte jej pouze tehdy, když jste si jisti, že odkaz již není potřeba pro připojení dokladu nebo připojení podpůrného dokumentu. Neodstraní identitu ani adresu uvedenou při registraci.

Externí ID souboru získáte z původní odpovědi na nahrání nebo ze seznamu dostupných nahraných souborů. Obslužná funkce nejprve vyhledá toto ID pro váš účet; pokud jej nenajde, použije jako záložní možnost starší způsob vyhledání podle ID poskytovatele. Nové integrace by měly používat externí odkaz přesně v podobě, v jaké byl vrácen. Tělo požadavku není vyžadováno.

O odstranění požádejte vědomě

Použijte aktivovaný účet rozhraní API služby MultiTEL přes HTTPS s nakonfigurovanými přihlašovacími údaji a omezeními IP adres. Použijte metodu POST, aby vaše aplikace tuto operaci považovala za záměrnou změnu:

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

Současná obslužná funkce nevynucuje omezení metody HTTP: i požadavek GET může vést k odstranění. Nezpřístupňujte tuto URL jako běžný odkaz, na který lze kliknout, obrázek, záložku ani cíl náhledu či předběžného načítání. Ve své aplikaci vyžadujte výslovnou akci odstranění a požadavek automaticky neopakujte.

Vyhodnoťte výsledek a jeho omezení

Přečtěte jak výsledek HTTP, tak hodnotu status.code v odpovědi ve formátu JSON. Běžná úspěšná odpověď má tuto podobu:

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

Kód API 404 se zprávou Failed, Not found znamená, že ani jeden ze způsobů vyhledání nenalezl odpovídající odkaz pro tento účet. Opakované odstranění proto může vrátit kód 404. Mezery na začátku a na konci hodnoty v cestě se odstraňují. Zde se nekontroluje, zda platnost odkazu dosud nevypršela ani zda jej nepoužívá jiný krok, proto před jeho odstraněním ověřte svůj pracovní postup.

Obslužná funkce po pokusu o odstranění z databáze ohlásí úspěch, aniž by zkontrolovala, zda se odstranění podařilo. Odpověď berte jako oznámený výsledek, nikoli jako nezávislý důkaz vymazání. Pokud byl v seznamu get_encrypted_files viditelný odkaz vytvořený prostřednictvím API, jehož platnost dosud nevypršela, může tento seznam pomoci ověřit, zda je odkaz stále viditelný. Jeho nepřítomnost v seznamu však může znamenat také vypršení platnosti.

Odstranění neznamená úplné vymazání dat

Obslužná funkce zadá příkaz k odstranění z tabulky odkazů na nahrané soubory. Výslovně neodstraňuje uložený řádek s obsahem dokumentu, místní nahraný soubor, připojený doklad, identitu, podpůrný dokument ani kopii uchovávanou poskytovatelem. Chování kaskádového mazání v databázi a uchovávání dat nebylo ověřeno. Neprezentujte uživatelům tuto operaci jako odstranění všech kopií jejich dokladu totožnosti ani jako splnění žádosti o úplné vymazání.

Po odstranění místního odkazu mohou selhat pozdější kroky připojování, které jej potřebují. Zachovejte výsledky již dokončených připojení a při změně odeslaných registračních údajů použijte příslušný postup pro správu identity nebo dokladů.