Ugrás a tartalomhoz

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:

bash
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:

bash
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 az id alapjá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 Requests vá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.