Nasc do r-siopa leis an API agus na webhooks

An bhfuil r-siopa nó do chóras féin agat? Le REST API Olvano déanann tú sonrascú gan cliceáil de láimh, agus le webhooks faigheann tú amach láithreach cad a tharlaíonn do shonrasc.

Token API

Fíordheimhnigh glaonna le token sa cheanntásc Authorization: Bearer …. Cruthaíonn úinéir an chuntais an token, baineann sé le cuntas amháin go díreach, agus iompraíonn sé a raon feidhme féin (invoices, expenses, reports). Ní thaispeántar an gnáth-théacs ach uair amháin — ní stóráiltear ach hais.

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

In ionad an API a cheistiú arís agus arís eile, cuir imeachtaí á mbrú chugat. Cláraigh URL agus roghnaigh na himeachtaí (nó * le haghaidh gach ceann):

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

• Iompraíonn gach seachadadh ceanntásc Idempotency-Key (UUID) — bain úsáid as chun dúbailtí a bhaint.
• Socraigh do authHeader féin chun a fhíorú gur ó Olvano a tháinig iarratas i ndáiríre.
• Déantar seachadadh teipthe a atriail suas le 5 huaire le cúlú easpónantúil.