Hendelsesstrøm
Følg hendelsene i org-en din i sanntid, og gjenoppta strømmen uten å miste noen.
Åpne strømmen
GET /v1/events/stream er en strøm med Server-Sent Events (SSE). Med klientId får du hendelsene til én klient. Uten klientId får du hele org-en, avgrenset til klientene nøkkelen har rett til.
Har du tilgang til flere org-er, velger du én med orgId. Ellers får du 409 ORG_FLERTYDIG.
curl -N -H "x-api-key: sk_live_..." "https://finance.ketl.no/api/v1/events/stream"Gjenoppta uten å miste hendelser
Hver melding har en id:-linje. Verdien er en cursor.
EventSource sender Last-Event-ID automatisk når den kobler til igjen. Med andre klienter sender du cursoren selv som ?etter=<cursor>. Er begge med, vinner Last-Event-ID.
Avspillingen går inntil 7 dager tilbake. Er cursoren eldre, får du 410. Hent da historikken med GET /v1/events og cursor.
Levering er minst én gang. Dedupliser på eventId.
Samme navn som webhooks
Standard er navn=domene. Da bruker event: domenets eget navn på hendelsen.
Med ?navn=katalog får event: webhook-katalogens kode, for eksempel faktura.utstedt. Hendelser uten kode i katalogen utelates.
Hjerteslag
Så lenge strømmen er åpen, sender serveren en ping i data:-linja hvert 30. sekund. Den er ingen hendelse, så koden din kan ignorere den.
{"type":"ping"}