Seznam dostupných referencí na nahrané soubory
Tento koncový bod použijte po nahrání registračních dokumentů v případě, že potřebujete vyhledat reference, které lze stále použít k připojení souborů. Použijte aktivovaný účet MultiTEL API prostřednictvím HTTPS s přihlašovacími údaji a omezeními IP adres nastavenými pro tento účet. Seznam je omezen na váš účet.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_filesNení vyžadováno tělo požadavku ani parametry dotazu. Obslužná funkce vypisuje záznamy o nahraných souborech vytvořené prostřednictvím API, u kterých není nastaven příznak vypršení platnosti a jejichž doba vypršení platnosti je pozdější než aktuální čas serveru. Neposkytuje žádné parametry pro stránkování, vyhledávání ani řazení. Nejde o seznam všech identit, dokladů ani historických dokumentů ve vašem účtu.
Čtení metadat, nikoli obsahu dokumentů
Zkontrolujte výsledek HTTP a hodnotu status.code v odpovědi ve formátu JSON. Úspěšná odpověď obsahuje pole v response; prázdným výsledkem je prázdné pole, nikoli chyba chybějícího účtu. Příklad používá smyšlená metadata a identifikátory.
{
"status": {"code": 200, "msg": ""},
"response": [{
"id": "0123456789abcdef0123456789abcdef",
"proof_type": "abcdef0123456789abcdef0123456789",
"entity_type": "addresses",
"description": "Example address proof",
"file_name": "example-document.pdf",
"date": "2026-10-01 12:00:00"
}]
}| Pole | Význam |
|---|---|
id | Externí reference na nahraný soubor. Pro příslušný požadavek na připojení ji zkopírujte přesně. Identifikátor sami nevypočítávejte ani jej nenahrazujte identifikátorem identity, adresy nebo šablony. |
proof_type | Maskovaná zaznamenaná reference na typ, pokud je k dispozici, jinak prázdný řetězec. U nahraných dokladů jde o typ dokladu; u nahraných podpůrných dokumentů se pod stejným klíčem zaznamenává reference na jejich šablonu. Rozlišíte je podle entity_type. Nejde o identifikátor nahraného souboru. |
entity_type | Zaznamenaná kategorie připojení, například identities, addresses nebo supporting_documents. Zvolte odpovídající postup připojení. |
description | Uložený popis nahraného souboru. |
file_name | Původní název souboru. Nejde o adresu URL pro stažení. |
date | Zaznamenaný čas vytvoření ve formátu stanoveném serverem bez uvedení posunu časového pásma. |
Odpověď neobsahuje obsah dokumentu, adresu URL úložiště ani okamžik vypršení platnosti. Uchovejte hodnotu expired_at z původní odpovědi na nahrání. Uvedení nahraného souboru v seznamu neprodlužuje jeho platnost, nepřipojuje jej k identitě ani nedokládá, že jej operátor schválil.
Připojte soubor před vypršením platnosti reference
Použijte odpovídající postup pro připojení dokladu nebo připojení podpůrného dokumentu. Současný postup nahrávání poskytuje referencím jen krátkou dobu platnosti; připojení neodkládejte jen proto, že se reference objevila v tomto seznamu. Mezi zobrazením seznamu a připojením může platnost reference vypršet nebo se reference může stát nedostupnou. Zpracujte odpověď na připojení a nepředpokládejte automaticky úspěch.
Pokud je seznam neočekávaně prázdný, zkontrolujte účet a ověřte, zda platnost nahraného souboru nevypršela nebo zda nebyl nahrán jiným postupem. Nenahrávejte automaticky stejné dokumenty znovu, aniž byste zkontrolovali výsledky původního nahrání a připojení.
Ochrana soukromí
Názvy souborů a popisy mohou identifikovat osoby nebo dokumenty, i když obsah souborů není součástí odpovědi. Omezte přístup a nezaznamenávejte do protokolů celé odpovědi. Informace o odstranění nepoužité lokální reference na nahraný soubor najdete v části odstranění reference na nahraný soubor; tato operace neposkytuje úplné vymazání dokumentů.