Taxfolio API pro AI agenty a skripty
Napojte na svůj účet AI asistenta (Claude, ChatGPT) nebo vlastní skript: čtení a zápis transakcí, portfolií, pozic a podkladů pro české daňové přiznání. Strojově čitelný kontrakt je v OpenAPI dokumentu.
Autentizace
API klíč si vytvoříte v aplikaci v Nastavení → API (vyžaduje aktivní předplatné nebo zkušební období). Klíč se posílá v hlavičce Authorization: Bearer tf_live_… a zobrazí se jen jednou - zacházejte s ním jako s heslem.
Klíč nese oprávnění (čtení / zápisy / mazání), která volíte při vytvoření. Přihlašovací session na API nefunguje - výhradně klíč.
Limity a kredity
Každý endpoint stojí kredity z denního rozpočtu podle výpočetní ceny (výpis transakcí 1, daňový podklad 25). Zbývající rozpočet vrací GET /api/v1/me/usage (zdarma) a hlavičky X-RateLimit-* u každé odpovědi.
Navíc platí minutový strop požadavků a malý souběh: na jeden klíč se zpracovávají nejvýš dva požadavky naráz a drahé výpočty sdílí frontu. Při 429 / 503 počkejte podle hlavičky Retry-After.
Bezpečné zápisy (idempotence)
Všechny zápisy vyžadují hlavičku Idempotency-Key (vámi zvolený klíč, např. UUID). Opakování požadavku se stejným klíčem vrátí uloženou odpověď a nic neprovede podruhé - retry po timeoutu je bezpečný a duplicitní transakce nevzniknou.
Chybové odpovědi mají vždy tvar { code, message }. Rozhodujte se podle code - text hlášky se může měnit.