Developers

Povežite svojo spletno trgovino prek API-ja in webhookov

Olvano ima REST API in webhooke — izdajajte račune programsko in se odzivajte na dogodke v realnem času.

Petr Svoboda

·2. 6. 2026

Imate spletno trgovino ali lasten sistem? Prek REST API-ja Olvanoa izstavljate račune brez ročnega klikanja, prek webhookov pa takoj izveste, kaj se dogaja z računom.

Žeton API

Klice overite z žetonom v glavi Authorization: Bearer …. Žeton ustvari lastnik uporabniškega računa, pripada natanko enemu računu in nosi lastne pravice (scopes: invoices, expenses, reports). Golo besedilo se prikaže samo enkrat — shrani se le odtis (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 } ] }'

Webhooki

Namesto da bi nenehno povpraševali API, si dajte dogodke pošiljati. Registrirate URL in izberete dogodke (ali * za vse):

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

Vsaka dostava nosi glavo Idempotency-Key (UUID) — uporabite jo za odstranjevanje podvojitev.
Nastavite svoj authHeader, da preverite, ali zahteva res prihaja od Olvanoa.
Neuspela dostava se ponovi do 5-krat z eksponentno naraščajočim zamikom.