Vývojáři

GET/v3/get_document/{uuid}

Načtení registračního profilu

Načtěte jeden aktivní profil patřící vašemu účtu podle UUID jeho místního dokumentu.

Na této stránce
  1. Načtení jednoho uloženého profilu
  2. Požadavek na profil
  3. Odpověď s profilem
  4. Vrácená pole profilu
  5. Nenalezený profil a opakování požadavků

Načtení jednoho uloženého profilu

Načtěte aktivní místní registrační profil vybraný podle UUID v rámci vašeho účtu. Vrátí se stejná omezená sada polí profilu jako u documents; ověření operátorem se neaktualizuje a připojené doklady se nevracejí.

Požadavek na profil

Ověřte se pomocí svého povoleného účtu MultiTEL API a IP adresy, která je pro něj povolena. Příklady používají přihlašovací údaje pro HTTP Basic uložené v proměnných prostředí. Zkontrolujte jak odpověď HTTP, tak pole JSON status.code; samotná odpověď HTTP 200 nepotvrzuje úspěch. Všechny hodnoty v příkladech jsou smyšlené.

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

Nastavte DOCUMENT_UUID na hodnotu response.uuid z create_document, nebo na hodnotu response[].id z documents. Nepoužívejte zde identity_id, address_id, ID dokladu ani telefonní číslo. Tělo požadavku není potřeba.

Odpověď s profilem

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "id": "11111111111111111111111111111111",
    "first_name": "Example",
    "last_name": "Person",
    "phone_number": "12025550123",
    "id_number": "",
    "birth_date": null,
    "company_name": "",
    "company_reg_number": "",
    "vat_id": "",
    "personal_tax_id": "",
    "description": "Example profile",
    "identity_type": "Personal",
    "postal_code": "00000",
    "city": "Example City",
    "address": "1 Example Street",
    "signature": "BASE64_PNG_SIGNATURE_DATA",
    "date_created": "2026-10-23 16:00:00"
  }
}

Vrácená pole profilu

Výběr vracených polí obsahuje id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature a date_created.

Nepovinné hodnoty mohou být podle uložených dat prázdné nebo null. Tento starší výběr vracených polí neobsahuje email, pole pro výběr země, identity_id, address_id, odkazy na nahrané soubory, seznamy dokladů ani stav ověření. Nejde o koncový bod pro zjištění stavu dokladů ani schválení registrace. S vrácenými údaji o totožnosti, kontaktními údaji a údaji podpisu zacházejte jako se soukromými.

Nenalezený profil a opakování požadavků

Kód API 404 se zprávou Failed, Not found znamená, že pro tento účet a UUID nebyl nalezen odpovídající aktivní profil. Zkontrolujte účet, identifikátor a to, zda profil nebyl odstraněn. Toto vyhledání nezpřístupňuje profil jiného účtu.

Úspěšné načtení nepotvrzuje přijetí dokladů ani aktivaci čísla. Pokud řešíte požadavek na vytvoření nebo připojení s nejistým výsledkem, zkontrolujte dokument v portálu před odesláním dalšího požadavku, který mění stav.