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