Developers

Qabbad l-e-shop tiegħek mal-API u l-webhooks

Olvano għandu REST API u webhooks — oħroġ fatturi b'mod programmatiku u rreaġixxi għall-avvenimenti f'ħin reali.

Petr Svoboda

·6/2/2026

Għandek e-shop jew sistema tiegħek? Bl-REST API ta' Olvano tiffattura mingħajr ikklikkjar manwali, u bil-webhooks issir taf minnufih x'jiġri minn fattura.

Token tal-API

Awtentika t-talbiet b'token fl-header Authorization: Bearer …. It-token jinħoloq mis-sid tal-kont, jappartjeni għal kont wieħed eżatt, u jġorr l-iscopes tiegħu stess (invoices, expenses, reports). It-test sempliċi jintwera darba biss — jinħażen biss 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 } ] }'

Webhooks

Minflok ma tistaqsi lill-API kontinwament, ħalli l-avvenimenti jiġu mbuttati lejk. Irreġistra URL u agħżel l-avvenimenti (jew * għal kollha):

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

Kull konsenja ġġorr header Idempotency-Key (UUID) — użaha biex telimina d-duplikati.
Issettja l-authHeader tiegħek stess biex tivverifika li talba verament ġiet minn Olvano.
Konsenja li tfalli terġa' tiġi pruvata sa 5 darbiet b'backoff esponenzjali.