Ugrás a tartalomhoz

Használat

Útmutatók

Végigvezetett integrációk gyakori használati esetekhez.

Az útmutatók lépésről lépésre mutatják be, hogyan oldj meg tipikus feladatokat a QUiCK API-val. Az alábbi minták a valós végpontokra épülnek; a teljes, kipróbálható listát az API Reference tartalmazza.

Költségbizonylatok kötegelt feltöltése

A POST /2/expenses/create/ végpont egy hívással legfeljebb 5 bizonylatot fogad, Base64-kódolt tartalommal:

bash
curl -X POST https://api.quick.riport.co.hu/2/expenses/create/ \
  -H "Authorization: Token $QUICK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expenses": [
      { "filename": "szamla1.pdf", "content": "<base64>" },
      { "filename": "szamla2.pdf", "content": "<base64>" }
    ],
    "source": "public_api"
  }'

A válasz a feldolgozott költségek azonosítóit adja vissza: { "processed": [90231, 90232] }.

Lapozott listák bejárása

A listavégpontok count / next / previous / results szerkezetben válaszolnak. A teljes lista bejárásához kövesd a next URL-t, amíg null nem lesz:

bash
curl "https://api.quick.riport.co.hu/1/expenses/?page=1&page_size=100" \
  -H "Authorization: Token $QUICK_API_TOKEN"

Oldalméret

A page_size növelésével kevesebb kérésből bejárható a lista, de a túl nagy oldalméret lassabb választ ad. Jellemzően az 50–200 közötti érték jó kompromisszum.

Céges kontextus kiválasztása

Ha egy tokened több céghez is használható, a Quick-Company-Id headerrel választhatod ki a cél céget. Elhagyva a cég a tokenből adódik. Részletek az Autentikáció oldalon.

Következő lépés

A fogalmi hátteret az Alapfogalmak oldal adja, a teljes végpontlistát pedig az API Reference oldalon böngészheted és próbálhatod ki.