Nahrání souborů s doklady pro registraci

Nejprve nahrajte, potom připojte

Nahrajte soubory pro jednu kategorii dokladu nebo podpůrného dokumentu a poté připojte vrácená ID souborů pomocí create_proof nebo create_supporting_document. Samotné nahrání nevytvoří identitu, adresu ani doklad a nedokončí registraci čísla. Začněte aktuálními požadavky a ID z katalogů.

Zadejte právě jeden výběrový parametr: proof_type_id pro doklad totožnosti či adresy, nebo supporting_template_id pro podpůrný dokument. Neposílejte oba. Použijte ID vrácená příslušným katalogem MultiTEL; zacházejte s nimi jako s neprůhlednými identifikátory, jejichž vnitřní strukturu nelze vykládat.

Požadavek na nahrání

Použijte aktivovaný účet API MultiTEL a IP adresu povolenou pro tento účet. Příklady používají přihlašovací údaje pro ověřování HTTP Basic z proměnných prostředí; dodržujte pravidla ověřování pro svůj typ účtu. Požadavky posílejte přes HTTPS. Zkontrolujte jak odpověď HTTP, tak následující pole v JSON: status.code; aplikační chyby mohou být vráceny i s HTTP 200. Níže uvedené příklady jsou smyšlené.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

Pole požadavku
Pole	Význam
`files[0] … files[4]`	Jeden až pět nahrávaných souborů. Použijte vícedílná formulářová data a nechte curl vygenerovat oddělovač pro Content-Type. Tato pole obsahují bajty souborů, nikoli URL ani Base64 v JSON.
`proof_type_id`	Povinné při nahrávání dokladu; použijte vrácené ID typu dokladu. Vynechte supporting_template_id.
`supporting_template_id`	U podpůrných souborů je povinné místo proof_type_id; použijte vrácené ID šablony.
`description`	Volitelný popis zadaný volajícím, nejvýše 100 znaků. Při nahrávání podpůrných souborů lze při vynechání popisu použít název šablony.

Omezení souborů

Tato obslužná funkce přijímá nejvýše pět souborů o celkové velikosti 20,000,000 bajtů. Jde o desetinný limit v bajtech, nikoli o 20 MiB. Infrastruktura nebo ověřování MIME mohou zavádět další omezení.

Seznam povolených přípon zahrnuje pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf a csv. Povolená přípona neprokazuje, že soubor splňuje zvolený požadavek registrace. Zejména přípona tif není na tomto seznamu povolených přípon.

Zkontrolujte každý vrácený soubor

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

Uložte si každé response.ids[].id pro požadavek na připojení. name označuje vrácený název zdrojového souboru. Používejte jedinečné názvy souborů a porovnejte vrácené soubory s očekávanou sadou: kód 200 může znamenat jen částečně úspěšnou dávku. Nepřipojujte sadu, v níž chybí povinné soubory.

entity_type má hodnotu identities nebo addresses pro doklad a supporting_documents při nahrávání podpůrných souborů. document_category má hodnotu proof nebo supporting. Obecně pojmenované pole proof_type v odpovědi obsahuje při nahrávání podpůrných souborů také odkaz na šablonu; pro připojení si ponechte původní supporting_template_id.

Připojte soubory co nejdříve

Služba nastavuje konec platnosti přibližně na 20 minut po místním uložení nahraného souboru. Při připojování se kontroluje, zda soubor patří stejnému účtu, není označen jako neplatný po vypršení, jeho platnost ještě nevypršela a má správnou kategorii entity. expired_at v této odpovědi neobsahuje posun časového pásma; nepředpokládejte, že jde o UTC. Připojte soubory co nejdříve, místo abyste práci plánovali na okamžik vypršení platnosti.

Vypršení platnosti odkazu na nahraný soubor nezaručuje, že v daný okamžik budou odstraněny všechny uložené kopie dokumentu. Služba šifruje soubory pro nahrání operátorovi a uchovává zdrojové bajty pro zpracování dokumentů; nepovažujte ji za šifrování pouze na straně klienta ani za službu bez uchovávání dat. ID, názvy souborů a odpovědi nezapisujte do veřejných protokolů.

Chyby a opakování požadavků

Současná obslužná funkce používá kód API 404, pokud nejsou dodány žádné soubory dokumentů, a kód 500 při chybách ověřování popisu, chybějících či konfliktních výběrových parametrech, neplatných ID typů dokladů či šablon, překročení limitu počtu souborů či celkové velikosti, problémech s úložištěm nebo neúspěšném nahrání. Přečtěte si status.msg; neplatný vstup není vždy označen kódem 400.

Klient zde nemá k dispozici klíč idempotence. Pokud se odpověď ztratí, před opakováním nahrání zkontrolujte stav zpracování dokumentů; další požadavek může vytvořit nové odkazy na soubory. Tyto příklady nebyly provedeny s doklady totožnosti zákazníků.