Developers

Napojte e-shop cez API a webhooky

Olvano má REST API a webhooky — vystavujte faktúry programovo a reagujte na udalosti v reálnom čase.

Petr Svoboda

·2. 6. 2026

Máte e-shop alebo vlastný systém? Cez REST API Olvano fakturujete bez ručného klikania a cez webhooky sa hneď dozviete, čo sa s faktúrou deje.

API token

Volania autentifikujete tokenom v hlavičke Authorization: Bearer …. Token vytvára vlastník účtu, patrí práve jednému účtu a nesie vlastné oprávnenia (scopes: invoices, expenses, reports). Plaintext sa zobrazí len raz — uloží sa z neho len odtlačok.

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

Webhooky

Namiesto toho, aby ste sa API dokola pýtali, necháte si udalosti poslať. Zaregistrujete URL a vyberiete udalosti (alebo * pre všetky):

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

Každé doručenie nesie hlavičku Idempotency-Key (UUID) — použite ju na deduplikáciu.
Ak nastavíte vlastný authHeader, overíte si, že request je naozaj od Olvano.
Neúspešné doručenie sa opakuje až 5× s exponenciálnym odstupom.