Kezdés

Első lépések

Készíts API kulcsot, állítsd ki az első teszt számlát és töltsd le a PDF-et pár perc alatt.

Ebben az útmutatóban ellenőrizzük a kapcsolatot, lekérdezzük a cég adatait, listázzuk a partnereket, végül feltöltünk egy költségbizonylatot. A teljes folyamat körülbelül 5 percet vesz igénybe.

Előfeltételek

Aktív QUiCK fiók Adminisztrátor szerepkörrel
Egy API token — a létrehozását az Autentikáció oldal írja le
Terminál curl-lel, vagy tetszőleges HTTP kliens (pl. HTTPie, Postman)

Állítsd be a tokent környezeti változóként, hogy a példák futtathatók legyenek:

bash

export QUICK_API_TOKEN="9c4f2e7a8b1d43f0a6e5c2b9d8f70123"

Ne commitold a tokent

Az API token teljes hozzáférést ad a céged könyvelési adataihoz. Soha ne kerüljön verziókezelt kódba, kliensoldali bundle-be vagy hibariportba.

1. Kapcsolat ellenőrzése

Először hívd meg a GET /1/pulse/ végpontot — ez ellenőrzi, hogy a tokened érvényes, és visszaadja a céghez tartozó pénztárak és bankszámlák állapotát:

bash

curl https://api.quick.riport.co.hu/1/pulse/ \
  -H "Authorization: Token $QUICK_API_TOKEN"

json

{
  "summary": 1284500,
  "accounts": [
    {
      "id": 12,
      "name": "Bank – HUF",
      "account_number": "12345678-00000000-00000000",
      "currency": "HUF",
      "current_balance": "1284500.00",
      "last_updated": "2026-07-14T08:12:00Z"
    }
  ]
}

Ha 401 Unauthorized a válasz, a token hibás vagy hiányzik — ellenőrizd az Authorization headert.

2. Cég azonosítása

A GET /2/company-info/ visszaadja a token cégének alapadatait. A id mező a céged azonosítója, amelyet szükség esetén a Quick-Company-Id headerhez használhatsz.

bash

curl https://api.quick.riport.co.hu/2/company-info/ \
  -H "Authorization: Token $QUICK_API_TOKEN"

json

{
  "id": 4821,
  "name": "Riport Applications Kft.",
  "tax_account_number": "12345678-2-42",
  "default_currency_name": "HUF",
  "advanced_accounting": true
}

3. Partnerek listázása

A listavégpontok lapozottak — a page és page_size query paraméterekkel vezérelheted:

bash

curl "https://api.quick.riport.co.hu/1/partners/?page_size=2" \
  -H "Authorization: Token $QUICK_API_TOKEN"

json

{
  "count": 128,
  "next": "https://api.quick.riport.co.hu/1/partners/?page=2&page_size=2",
  "previous": null,
  "results": [
    {
      "id": 5501,
      "name": "Teszt Vevő Kft.",
      "tax_number": "12345678-2-42",
      "city": "Budapest",
      "zip_code": "1051",
      "is_customer": true,
      "is_vendor": false
    }
  ]
}

4. Költségbizonylat feltöltése

A költségeket bizonylat feltöltésével rögzíted: a POST /2/expenses/create/ végpont a fájl tartalmát Base64-kódolva várja a content mezőben, a fájlnévvel együtt. Egy hívással legfeljebb 5 bizonylatot tölthetsz fel.

bash

CONTENT=$(base64 -i szamla.pdf)

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\": \"szamla.pdf\", \"content\": \"$CONTENT\" }
    ],
    \"source\": \"public_api\"
  }"

A válasz a feldolgozásra átvett költségek azonosítóit adja vissza:

json

{
  "processed": [90231]
}

A rendszer a feltöltött bizonylatból dolgozza fel a költség adatait; a részletek utólag a GET /1/expenses/ vagy GET /2/expenses/{expenseId}/ hívással kérdezhetők le.

Verziók: `/1/` és `/2/`

A /1/ végpontok a stabil olvasó- és alapműveletekhez valók, a /2/ végpontok a bővített, gyakran kötegelt könyvelési műveletekhez (létrehozás, hozzárendelések, törzsadatok). Egy integráció szabadon vegyítheti a kettőt.

Következő lépés

Ismerd meg az Alapfogalmak oldalon a QUiCK erőforrás-modelljét
Nézd meg az Autentikáció oldalt a token- és cégkezelés részleteiért
Böngészd a teljes végpontlistát az API Reference oldalon, ahol minden hívás kipróbálható