Nástroje
Než začnete psát vlastního klienta, podívejte se, jestli za vás něco už není napsané.
Co si vybrat
| Chci… | Použijte |
|---|---|
| psát integraci v PHP | PHP SDK |
| napojit AI asistenta (Claude a spol.) na účetnictví | MCP server |
| zkusit si volání bez psaní kódu | kolekci pro API klienty |
| vygenerovat klienta ve svém jazyce | OpenAPI specifikaci |
| jen přenést data z jiného systému | hotové importy — možná nemusíte psát nic |
| vyzkoušet skutečné chování aplikace | druhou, zkušební firmu — veřejné testovací prostředí není |
Kolekce pro API klienty
Ke každé operaci v referenci je tlačítko Otevřít v API klientu. Rozbalí panel se třemi cestami, protože každý klient se obsluhuje jinak:
| Klient | Co tlačítko udělá |
|---|---|
| Postman | stáhne kolekci ve formátu Postman v2.1; v Postmanu pak Import → soubor |
| Insomnia | otevře oficiální Run in Insomnia s adresou kolekce — potřebuje veřejnou adresu, z lokálního náhledu to nefunguje |
| Bruno | zkopíruje do schránky adresu openapi.yaml; Bruno deep link ani import Postman kolekce z URL nemá, načítá se přes Import → OpenAPI |
Kolekci si můžete stáhnout i přímo, bez tlačítka: iucto-api-1.3.postman_collection.json.
Klíč je v kolekci proměnná apiKey — vyplníte ho jednou a nerozešlete ho
spolu se souborem.
Ostré API neposílá hlavičky CORS, takže požadavek odeslaný ze stránky dokumentace by prohlížeč zablokoval — cesta ven vede přes klienta na vašem počítači nebo přes terminál.
OpenAPI specifikace
Celý popis API v OpenAPI 3.1 je na stabilní adrese:
https://developers.iucto.cz/spec/openapi.yaml
Je to jeden soubor se všemi 161 operacemi včetně schémat, příkladů a popisů.
Použijete ho na generování klienta (openapi-generator, oapi-codegen,
NSwag), na validaci nebo ho můžete celý předložit jazykovému modelu.
Hotové importy do iÚčta
Pokud potřebujete jen dostat doklady z jiného systému do iÚčta, podívejte se nejdřív do aplikace pod Nastavení → Rozšíření. iÚčto umí importovat mimo jiné ze Shoptetu, Fakturoidu a iDokladu. To je hotová funkce aplikace, ne něco, co byste programovali přes API.
Vlastní integraci pište, až když potřebujete něco, co import neumí — jiný zdroj dat, vlastní logiku nad doklady, nebo obousměrné napojení.