Developers

Ühenda oma e-pood API ja veebihookide kaudu

Olvano'il on REST API ja veebihoogid — väljasta arveid programmaatiliselt ja reageeri sündmustele reaalajas.

Petr Svoboda

·2.6.2026

Kas sul on e-pood või oma süsteem? Olvano'i REST API-ga esitad arveid ilma käsitsi klikkimata ja veebihookidega saad kohe teada, mis arvega juhtub.

API-token

Autendi päringud tokeniga päises Authorization: Bearer …. Tokeni loob konto omanik, see kuulub täpselt ühele kontole ja kannab oma õigusi (scope'id: invoices, expenses, reports). Avatekst kuvatakse vaid korra — sellest salvestatakse ainult räsi.

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

Veebihoogid

Selle asemel et API-d pidevalt pärida, lase sündmused endale tõugata. Registreeri URL ja vali sündmused (või * kõigi jaoks):

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

Iga kohaletoimetamine kannab päist Idempotency-Key (UUID) — kasuta seda dubleerimise vältimiseks.
Määra oma authHeader, et kontrollida, kas päring tuli tõesti Olvano'ist.
Ebaõnnestunud kohaletoimetamist proovitakse uuesti kuni 5 korda eksponentsiaalse viivitusega.