Fejlett
Webhookok
Események fogadása aláírt payloaddal, kézbesítési garanciák és újrapróbálkozás.
A QUiCK API jelenleg nem küld webhookot — nincs esemény-előfizetés vagy visszahívott (callback) végpont. A rendszerben történt változásokat lekérdezéssel (polling) követed: időnként lekéred a listavégpontokat, és feldolgozod az utolsó szinkron óta keletkezett vagy módosult tételeket.
Változások lekérdezése dátum szerint
A költséglista dátum szerint szűrhető és rendezhető, így hatékonyan lekérdezhetők az adott időpont óta létrejött tételek. A date_field választja ki a szűrt dátummezőt, a from_date a kezdő dátumot, az ordering pedig a sorrendet:
curl "https://api.quick.riport.co.hu/1/expenses/?date_field=created&from_date=2026-07-01&ordering=-created&page_size=100" \
-H "Authorization: Token $QUICK_API_TOKEN"A válasz lapozott (count / next / previous / results); kövesd a next URL-t az összes új tétel begyűjtéséhez.
Bevételek követése
A bevételek a from_date paraméterrel szűrhetők hasonló módon:
curl "https://api.quick.riport.co.hu/1/incomes/?from_date=2026-07-01&page_size=100" \
-H "Authorization: Token $QUICK_API_TOKEN"Egyenleg figyelése
A pénztárak és bankszámlák aktuális egyenlegét a GET /1/pulse/ adja vissza — ezt gyakrabban is lekérdezheted, mint a teljes költséglistát, mivel egyetlen, könnyű választ ad.
Ajánlott polling-minta
- Tárold el az utolsó sikeres szinkron időpontját, és a következő lekérdezésnél ezt add meg
from_date-ként. - Használj kis átfedést (pl. egy nappal korábbi
from_date), hogy a határon lévő tételek ne maradjanak ki; a duplikátumokat azidalapján szűrd ki. - Ne pollozz túl sűrűn. A rövid intervallumú, gyakori lekérdezés feleslegesen terheli az API-t; a legtöbb könyvelési integrációnak elég a perces–órás szinkron. Túl sok kérésnél
429 Too Many Requestsválasz jöhet.
Miért nincs webhook?
A könyvelési adatok jellemzően nem igényelnek valós idejű, ezredmásodperces feldolgozást, ezért a QUiCK a kiszámítható, kliensoldalról vezérelt lekérdezést részesíti előnyben. Ha a jövőben lesz esemény-alapú értesítés, azt itt dokumentáljuk.