Založení ověření kontaktu

ℹ️ Nová verze Signi ověření (včetně tohoto API) bude na produkci zveřejněna v průběhu září 2026. Do té doby volání nejsou dostupná a popis se může drobně změnit.

Ověření můžete založit přímo na kontaktu z adresáře workspace — nezávisle na jakémkoli dokumentu. Hodí se pro ověření „do zásoby": dokud je platné, uplatní se automaticky u dokumentů, které s tímto kontaktem později založíte.

Založení

Kontakt určíte buď contactUuid, nebo contactEmail — právě jedním z nich:

curl -X POST -H "x-api-key: VAS_API_KLIC" -H "Content-Type: application/json" \
  https://api.signi.com/api/v2/verifications \
  -d '{
    "contactEmail": "jan.novak@email.cz",
    "offeredGroups": ["11111111-2222-3333-4444-555555555555"]
  }'

{
    "uuid": "aaaa1111-bbbb-2222-cccc-333344445555",
    "verificationUrl": "https://app.signi.com/…",
    "tokenExpiresAt": "2027-02-01T12:00:00+01:00"
}

• offeredGroups — 1–2 UUID skupin ověření, ze kterých si ověřovaný vybere.
• verificationUrl — uvítací odkaz, přes který ověřovaný ověřením projde.
• notify — jestli má Signi poslat ověřovanému e-mail s odkazem (výchozí true); odkaz mu můžete předat i sami.
• redirectUrl — kam ověřovaného přesměrovat po dokončení.
• webhooks — hlášení změn stavu tohoto ověření, viz Webhooky ověření.

Každé volání založí nový běh ověření — existující se tady nerecykluje (to dělá jen navázání na dokument).

Detail ověření

curl -H "x-api-key: VAS_API_KLIC" https://api.signi.com/api/v2/verifications/UUID_OVERENI

Vrátí stav, nabídnuté i zvolenou skupinu, časy jednotlivých kroků a výsledky po komponentách:

{
    "uuid": "aaaa1111-bbbb-2222-cccc-333344445555",
    "status": "approved",
    "group": "11111111-2222-3333-4444-555555555555",
    "expiresAt": "2028-02-01T12:00:00+01:00",
    "results": [
        {
            "component": "document",
            "result": "success",
            "extractedData": { "…": "vytěžené osobní údaje, pokud je vytěžování zapnuté" },
            "statusData": { "…": "technická metadata poskytovatele" },
            "files": { "…": "podepsané, časově omezené odkazy na uložené soubory" }
        }
    ]
}

Historie ověření kontaktu

Všechna ověření kontaktu, nejnovější první — podle UUID kontaktu, nebo podle e-mailu:

curl -H "x-api-key: VAS_API_KLIC" https://api.signi.com/api/v2/verifications/contact/UUID_KONTAKTU
curl -H "x-api-key: VAS_API_KLIC" "https://api.signi.com/api/v2/verifications/contact?email=jan.novak@email.cz"

Každá položka nese stav, časy, důvod případného zamítnutí či odmítnutí a název skupiny.

Kam dál

• Signi ověření — jak funguje
• Schválení a zamítnutí ověření