REST API
Pre vývojárov a firmy s vlastnými systémami ponúka Fakturuj.si kompletné REST API. Vytvárajte faktúry, spravujte kontakty, sledujte platby a automatizujte ľubovoľné procesy priamo z vášho softvéru. API podporuje webhooky pre real-time notifikácie o udalostiach.
Ako to funguje
Fakturuj.si REST API je RESTful rozhranie s JSON formátom dát. Autentifikácia prebieha cez API kľúč v hlavičke požiadavky. API pokrýva všetky funkcie Fakturuj.si — CRUD operácie pre faktúry, kontakty, produkty aj platby. Webhooky umožňujú prijímať okamžité notifikácie o udalostiach (nová faktúra, platba, zmena stavu) na vami zadanú URL adresu.
Nastavenie krok za krokom
Získanie API kľúča
V nastaveniach účtu Fakturuj.si vygenerujte API kľúč s požadovanými oprávneniami.
Prečítanie dokumentácie
Preštudujte API dokumentáciu s popisom všetkých endpointov, parametrov a príkladov.
Nastavenie webhookov
Nakonfigurujte webhooky pre udalosti, na ktoré chcete reagovať vo vašom systéme.
Implementácia
Implementujte integráciu vo vašom programovacom jazyku. K dispozícii sú SDK pre PHP, Python a Node.js.
Výhody integrácie
Kompletné REST API pokrývajúce všetky funkcie
Webhooky pre real-time notifikácie
SDK pre PHP, Python a Node.js
Podrobná dokumentácia s príkladmi kódu
Sandbox prostredie pre testovanie
Často kladené otázky
API povoľuje 1000 požiadaviek za hodinu na jeden API kľúč. Pre vyššie limity nás kontaktujte ohľadom Enterprise plánu.
Áno, všetky zoznamové endpointy podporujú stránkovanie pomocou parametrov page a per_page. Odpovede obsahujú metadáta o celkovom počte záznamov.
Webhooky odosielajú HTTP POST požiadavky na vami zadanú URL pri udalostiach ako vytvorenie faktúry, prijatie platby alebo zmena stavu. Payload obsahuje kompletné dáta o udalosti.
Áno, API komunikuje výhradne cez HTTPS. API kľúče majú konfigurovateľné oprávnenia a všetky požiadavky sú logované.