API pro integrátory

Kontrola dodavatele jako API endpoint

Zapojte ARES, registr DPH, VIES, OR, RŽP a insolvenční rejstřík do svého ERP nebo účetního SW. Scoped tokeny, HMAC webhooky, OpenAPI spec.

OpenAPI dokumentace Ceník

Rychlý start

curl -X POST https://kontrolafirmy.cz/api/v1/checks \
  -H "Authorization: Bearer $KONTROLA_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"ico":"27082440","country":"CZ"}'

Scoped tokeny

Každý token má vlastní oprávnění (check:read, monitoring:write…). Limit blast radius při úniku.

Hromadná kontrola

Až 50 IČO v jednom volání. Per-item účtování denního limitu.

HMAC webhooky

Outbound POST s podpisem SHA-256, retry 5× s exponential backoff, auto-disable po 50 selháních.

OpenAPI / Postman

Strojově generovaná dokumentace. Naimportujte si /docs/openapi.yaml do svého klienta.

IP allowlist

Každý token může být zamčený na konkrétní IP adresy. Pro prod integraci nutnost.

Idempotency-Key

Retry-safe POSTy. Dvakrát stejný key = jedna kontrola, jeden kredit.

Klíčové endpointy

Metoda	Cesta	Popis
POST	/api/v1/checks	Jednorázová kontrola subjektu
POST	/api/v1/checks/bulk	Hromadná synchronní kontrola až 50 subjektů
GET	/api/v1/monitoring	Sledování subjektů a alerty
POST	/api/v1/batch	Asynchronní CSV import
GET	/api/v1/webhooks	Správa outbound webhooků
GET	/api/v1/usage	Aktuální využití plánu
GET	/api/v1/logs	Log API požadavků
GET	/api/v1/gdpr/export	GDPR export osobních dat

Webhook payload

Každá změna u sledovaného subjektu přijde na vaši URL jako POST s hlavičkou X-KF-Signature (HMAC SHA-256).

{
  "event": "monitoring.alert.created",
  "delivered_at": "2026-04-22T10:15:00+00:00",
  "data": {
    "alert_id": 42,
    "subject": {"id": 7, "ico": "27082440", "country": "CZ"},
    "risk_level_before": "ok",
    "risk_level_after": "warning",
    "changes": [{"source": "DPH", "field": "is_unreliable_payer", "type": "changed"}]
  }
}

Enterprise integrace

Dedikovaný plán s vyššími limity, custom SLA a podporou. Napište nám.

[email protected]