Developers

Kösse össze webáruházát az API-val és a webhookokkal

A Olvano-nek van REST API-ja és webhookjai — állítson ki számlákat programozottan, és reagáljon az eseményekre valós időben.

Petr Svoboda

·2026. 06. 02.

Van webáruháza vagy saját rendszere? A Olvano REST API-jával kézi kattintgatás nélkül számláz, a webhookokkal pedig azonnal megtudja, mi történik egy számlával.

API token

A hívásokat egy tokennel hitelesíti az Authorization: Bearer … fejlécben. A tokent a fiók tulajdonosa hozza létre, pontosan egy fiókhoz tartozik, és saját jogosultságokat (scopes: invoices, expenses, reports) hordoz. A nyílt szöveg csak egyszer jelenik meg — csak egy lenyomat (hash) tárolódik belőle.

curl -X POST "$STARGATE/api/accounts/$SLUG/invoices" \
  -H "Authorization: Bearer sg_your_token" \
  -H "Content-Type: application/json" \
  -d '{ "subjectId": "ID", "lines": [ { "name": "Item", "unitPrice": "1000", "vatRate": 21 } ] }'

Webhookok

Ahelyett, hogy folyamatosan kérdezgetné az API-t, küldesse magának az eseményeket. Regisztrál egy URL-t, és kiválasztja az eseményeket (vagy * az összeshez):

invoice_created, invoice_sent, invoice_paid, invoice_overdue, invoice_cancelled, invoice_uncollectible, invoice_viewed, invoice_reminder_sent, recurring_generator_invoice_created.

Minden kézbesítés egy Idempotency-Key fejlécet (UUID) hordoz — ezzel szűrheti ki a duplikátumokat.
Állítson be saját authHeader-t, hogy ellenőrizhesse: a kérés valóban a Olvano-től jött.
A sikertelen kézbesítést a rendszer legfeljebb 5-ször ismétli meg, exponenciálisan növekvő várakozással.