Developers

Savieno savu e-veikalu ar API un tīmekļa āķiem

Olvano ir REST API un tīmekļa āķi — izraksti rēķinus programmatiski un reaģē uz notikumiem reāllaikā.

Petr Svoboda

·2.06.2026.

Vai tev ir e-veikals vai sava sistēma? Ar Olvano REST API tu izraksti rēķinus bez manuālas klikšķināšanas, bet ar tīmekļa āķiem uzreiz uzzini, kas notiek ar rēķinu.

API marķieris

Autentificē pieprasījumus ar marķieri galvenē Authorization: Bearer …. Marķieri izveido konta īpašnieks, tas pieder tieši vienam kontam un nes savas tiesības (scopes: invoices, expenses, reports). Atklātais teksts tiek parādīts tikai vienreiz — no tā tiek saglabāts vienīgi jaucējkods.

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

Tīmekļa āķi

Tā vietā, lai pastāvīgi vaicātu API, ļauj notikumus nosūtīt tev. Reģistrē URL un izvēlies notikumus (vai * visiem):

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

Katra piegāde nes galveni Idempotency-Key (UUID) — izmanto to dublikātu novēršanai.
Iestati savu authHeader, lai pārliecinātos, ka pieprasījums tiešām nāk no Olvano.
Neveiksmīga piegāde tiek atkārtota līdz 5 reizēm ar eksponenciālu aizturi.