Požiadavky a odpovede

Fintoro API používa JSON a názvy polí v camelCase. PDF endpointy vracajú súbor s typom application/pdf.

Hlavičky

Každá požiadavka potrebuje API token. Pri posielaní JSON tela pridajte Content-Type: application/json:

Authorization: Bearer <company-token>
Accept: application/json
Content-Type: application/json

Formát odpovedí

Zoznamy vracajú pole data. Prázdny zoznam má tvar:

{
  "data": []
}

Detail a odpovede po vytvorení alebo úprave vracajú objekt priamo, bez obalu data. Zoznam môže obsahovať menej údajov než detail; napríklad zoznam faktúr neobsahuje ich položky.

Stránkovanie a filtre

Stránkované endpointy prijímajú page a perPage a vracajú objekt paginator. Napríklad prvú stránku faktúr načítate takto:

curl --get \
  --url https://app.fintoro.sk/api/public/v1/invoices \
  --header 'Authorization: Bearer <company-token>' \
  --data-urlencode 'page=1' \
  --data-urlencode 'perPage=10'

Skrátená ilustračná odpoveď:

{
  "data": [
    { "id": 301, "number": "20260001" }
  ],
  "paginator": {
    "currentPage": 1,
    "perPage": 10,
    "totalPages": 1,
    "totalResults": 1,
    "nextPageUrl": null
  }
}

nextPageUrl obsahuje odkaz na ďalšiu stránku alebo null, ak ste na konci. Číselníky a niektoré ďalšie zoznamy vracajú všetky výsledky naraz, bez paginator. Dostupné filtre, možnosti zoradenia a limity perPage sú uvedené pri konkrétnom endpointe v API referencii.

Jazyk odpovedí

Jazyk systémových názvov a validačných chýb zvolíte hlavičkou Accept-Language:

Accept-Language: en

Hlavička ovplyvní názvy v číselníkoch aj rovnaké objekty vnorené v odpovediach. Názvy klientov, poznámky a ostatné používateľské údaje zostanú nezmenené. Podporované jazykové tagy: sk, en, cs, de, et, es, fr, hr, hu, it, lt, nl, pl, pt, ro, sr, ru, sl, uk. Bez hlavičky alebo pri nepodporovanom jazyku sa použije slovenčina (sk). Vybraný jazyk nájdete v hlavičke odpovede Content-Language. Štandardné validačné správy sú v slovenčine pri sk aj cs, v angličtine pri ostatných uvedených jazykoch. Content-Language označuje vybraný jazyk požiadavky, aj keď je validačná správa v náhradnom jazyku.

Začíname

Práca s API

Webhooky

Príklady

Požiadavky a odpovede

Hlavičky

Formát odpovedí

Stránkovanie a filtre

Jazyk odpovedí