Developers

Povežite svoju web trgovinu putem API-ja i webhookova

Olvano ima REST API i webhookove — izdajte račune programski i reagirajte na događaje u stvarnom vremenu.

Petr Svoboda

·02. 06. 2026.

Imate web trgovinu ili vlastiti sustav? Putem REST API-ja Olvanoa fakturirate bez ručnog klikanja, a putem webhookova odmah doznajete što se događa s računom.

API token

Pozive autenticirate tokenom u zaglavlju Authorization: Bearer …. Token stvara vlasnik korisničkog računa, pripada točno jednom računu i nosi vlastite ovlasti (scopes: invoices, expenses, reports). Otvoreni tekst prikazuje se samo jednom — pohranjuje se samo otisak (hash).

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 } ] }'

Webhookovi

Umjesto da neprestano propitujete API, pustite da vam se događaji šalju. Registrirate URL i odaberete događaje (ili * za sve):

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

Svaka isporuka nosi zaglavlje Idempotency-Key (UUID) — upotrijebite ga za deduplikaciju.
Postavite vlastiti authHeader da provjerite je li zahtjev doista došao od Olvanoa.
Neuspjela isporuka ponavlja se do 5 puta uz eksponencijalno povećanje razmaka.