Prvé volanie API

Príklad načíta doklady cez POST /v2/documents. Pripravte si API kľúč a IČO firmy, ku ktorej má integrácia prístup.

1. Pripravte API kľúč

V termináli spustite nasledujúci príkaz. Hodnotu VYGENEROVANY_API_KEY_V_DOKLADO nahraďte svojím API kľúčom z Doklado a úvodzovky ponechajte.

DOKLADO_API_KEY="VYGENEROVANY_API_KEY_V_DOKLADO"

Nasledujúce volanie API spustite v tom istom termináli.

2. Načítajte doklady

Nahraďte vzorové IČO 12345678 vlastným IČO. Dátumový rozsah upravte podľa údajov vo svojej firme.

curl --request POST \
  'https://api-gateway-prod-europe-west-1-7epuecvu.ew.gateway.dev/v2/documents' \
  --header "api_key: ${DOKLADO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
    "data": {
      "organizationId": "12345678",
      "dateFrom": "2026-09-01T00:00:00Z",
      "dateTo": "2026-09-14T00:00:00Z",
      "dateType": "issue",
      "orderBy": "issue_date",
      "orderByDescending": false,
      "resourceTypes": ["receipt", "invoice"]
    }
  }'

Pole organizationId má typ string; úvodzovky zachovajte aj pri číselnom IČO. Obálka data je súčasťou vstupnej schémy.

3. Spracujte odpoveď

Skontrolujte HTTP stav aj polia success a code v odpovedi. Pole data obsahuje pole dokladov podľa schém DocumentV2 alebo InvoiceV2. HTTP 200 samo osebe nepotvrdzuje aplikačný úspech.

Pri ďalšej strane použite vrátené pole searchAfter podľa návodu Stránkovanie a chyby. Kód APP_NO_MORE_DATA označuje, že už nie sú dostupné ďalšie údaje.

Prázdny výsledok môže zodpovedať zvolenému obdobiu. Overte IČO, filtre a dostupnosť dokladov.

Ďalšie kroky

Na stránke Ako správne pracovať s API nájdete cURL príklady práce so stavom exportu aj dátumovým rozsahom a postupy na obmedzenie opakovanej spotreby.

V prehľade endpointov nájdete operácie na detail dokladu, prílohy, export aj vystavené faktúry. Kompletné dátové modely a odpovede sú v sekcii REST API referencia.

Zdroj technických parametrov: OpenAPI špecifikácia Doklado.