Verze API: 1.3
iÚčto API
Veřejné REST API účetního systému online.iucto.cz.
API je postavené na REST architektuře a komunikuje výhradně přes HTTPS.
Odpovědi jsou ve formátu HAL+JSON,
tělo požadavků POST a PUT musí být JSON. Každý požadavek musí nést hlavičku
X-Auth-Key s API klíčem.
Odkazy v popisech níže jsou relativní k https://developers.iucto.cz — když si tenhle soubor stáhnete zvlášť, doplňte si tu adresu před ně.
Koncepty společné všem zdrojům jsou v průvodci:
- Úvod — základní URL, HTTP metody, odpovědi serveru
- Začínáme — tři kroky k prvnímu úspěšnému volání
- Autentizace — jak získat a používat API klíč
- Stránkování, řazení a filtry —
page,pageSize,sorta filtry seznamů - Datové typy — formáty hodnot a kódy typů dokladů
- Chyby a jak je číst — stavové kódy a tvary chybového těla
- Limity a kvóty — kolik dotazů má který tarif a jak je šetřit
- Co platí pro všechny doklady — neplátci DPH, zaúčtování položek, upomínky, EET a režim One Stop Shop
- Číselníky — které pole čerpá hodnoty z kterého endpointu
- Webhooky — oznámení o vzniku, změně a úhradě dokladu
- Slovníček pojmů — co je DUZP, ODD nebo zaúčtování
- Přehled změn — co přibylo v jednotlivých verzích API
Autorizace
- API Key: ApiKeyAuth
API klíč firmy. Vygeneruje se v aplikaci v Nastavení → Nastavení API.
Klíč je vázaný na uživatele, takže oprávnění v API odpovídají jeho oprávněním ve webovém rozhraní.
Typ zabezpečení: | apiKey |
|---|---|
Název hlavičky: | X-Auth-Key |