REST API - čo všetko ovláda
- Faktúry - vytvorenie, úprava, vystavenie, odoslanie e-mailom, PDF download
- Klienti - CRUD, vyhľadanie podľa IČO, import z registra
- Položky a ceny - katalóg položiek, zmena cenníka
- Náklady - pridanie prijatej faktúry, upload dokladu
- Platby - zoznam transakcií, manuálne párovanie
- Reporty - obrat, pohľadávky, cashflow
- Nastavenia - číselné rady, šablóny, upomienky
Plná OpenAPI dokumentácia je verejne dostupná na api.mojefaktury.sk/docs. Generujeme ju priamo zo zdrojového kódu, takže je vždy aktuálna.
Webhooky - keď chcete byť informovaní
Namiesto pollovania API pre zmeny môžete prijímať HTTP POST požiadavky pri udalostiach. Podporované udalosti:
invoice.issued- vystavená faktúrainvoice.sent- odoslaná klientovi e-mailominvoice.paid- klient zaplatil (po párovaní)invoice.overdue- faktúra je po splatnostiinvoice.credit_note_issued- vystavený dobropisclient.created,client.updated- zmena klientaexpense.created- pridaný náklad
HMAC podpis webhookov
Každý webhook obsahuje HTTP hlavičku X-MojeFaktury-Signature s hexadecimálnym HMAC-SHA256 podpisom payloadu. Overením podpisu si zaručíte, že požiadavka pochádza od nás a nebola modifikovaná (napr. man-in-the-middle alebo podvrhnuté volanie).
- Secret pre HMAC získate pri vytvorení webhook endpointu
- Verifikácia v kóde:
hmac_sha256(secret, raw_body) == header_signature - Pri neplatnom podpise vráťte 401 - systém skúsi doručenie znova
Retry a doručovanie
Ak váš endpoint vráti chybu (napr. 500 alebo timeout), systém skúsi doručenie znova s exponenciálnym backoffom: 1 min, 5 min, 15 min, 1 h, 6 h, 24 h. Po 6 zlyhaniach sa webhook označí ako nedoručený a dostanete e-mailovú notifikáciu.
Vo webhook logu (v Dashboard → API & webhooky) vidíte všetky odoslané webhooky s odpoveďou vášho servera - užitočné pri debuggingu.
Často kladené otázky
Koľko stojí API prístup?
API je súčasťou Pro a Agency plánov bez dodatočných poplatkov. Rate limity sú v rádoch desiatok požiadaviek za sekundu, čo stačí pre e-shop s tisíckami objednávok mesačne.
Aké sú SLA pre API?
99,5% dostupnosť (cca 3,6 hodiny výpadku mesačne). Pre Agency plán je k dispozícii 99,9% SLA s pokročilou podporou.
Ako zabezpečiť API kľúč v produkcii?
Kľúč nikdy nevkladajte do frontendu ani do verejného repozitára. Uchovávajte v prostredí (ENV variables), využívajte secret managery (Vault, AWS Secrets Manager). Pri úniku kľúča ho okamžite revokujte a vygenerujte nový.