Developers

Yhdistä verkkokauppasi API:n ja webhookien avulla

Olvanossa on REST-API ja webhookit — laadi laskuja ohjelmallisesti ja reagoi tapahtumiin reaaliajassa.

Petr Svoboda

·2.6.2026

Onko sinulla verkkokauppa tai oma järjestelmä? Olvanon REST-API:lla laskutat ilman manuaalista klikkailua, ja webhookien avulla saat heti tietää, mitä laskulle tapahtuu.

API-token

Todenna kutsut tokenilla Authorization: Bearer … -otsakkeessa. Tokenin luo tilin omistaja, se kuuluu täsmälleen yhdelle tilille ja kantaa omat käyttöoikeutensa (scopet: invoices, expenses, reports). Selkoteksti näytetään vain kerran — siitä tallennetaan vain tiiviste.

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

Webhookit

Sen sijaan että kyselisit API:lta jatkuvasti, anna tapahtumien tulla työnnettyinä sinulle. Rekisteröi URL-osoite ja valitse tapahtumat (tai * kaikille):

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

Jokainen toimitus kantaa Idempotency-Key-otsakkeen (UUID) — käytä sitä kaksoiskappaleiden poistoon.
Aseta oma authHeader, niin voit varmistaa, että pyyntö tuli todella Olvanosta.
Epäonnistunut toimitus yritetään uudelleen enintään 5 kertaa eksponentiaalisella viiveellä.