Hopp til innholdet
Sursa Developers

Hendelser · Fakturering

credits.low

Lite kreditter igjen

Kredittsaldoen for perioden passerte en forbruksterskel (data.threshold, prosent av forbruksrammen som er brukt). Sendes én gang per terskel og periode.

Objekttype
org
Leveres til
Endepunkter med rollen admin

Nyttelast

Objekt: EventCreditsLow

  • idstringobligatorisk

    Hendelsens ID (evt_…), sendes også som headeren webhook-id. Bruk den til å forkaste dupliserte leveranser.

  • typestringobligatorisk

    Tillatte verdier: credits.low

  • created_atstring (date-time)obligatorisk

    Når endringen skjedde (UTC).

  • org_idintegerobligatorisk
  • api_versionstringobligatorisk

    Kontraktversjonen for skjemaet til data.

  • sequenceinteger

    Leveransens løpenummer innenfor endepunktet (mangler for en testhendelse).

  • objectWebhookEventObjectobligatorisk
  • payloadstringobligatorisk

    thin betyr ingen data: les objektet via API-et.

    Tillatte verdier: fullthin

  • dataobject
    Felt
    • thresholdintegerobligatorisk

      Terskel i prosent av brukt forbruksramme: 80 eller 100.

    • period_startstring (date)obligatorisk
    • balancenumber
    • allowancenumber
  • testbooleanobligatorisk

    En testhendelse sendt av POST /v1/webhooks/{webhook_id}/test.

Eksempel på leveranse

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "credits.low",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "org",
    "id": "1"
  },
  "payload": "full",
  "data": {
    "threshold": 80,
    "period_start": "2026-10-01",
    "balance": 1000,
    "allowance": 5000
  },
  "test": false
}

Motta hendelser

Hver leveranse er en POST-forespørsel med denne JSON-brødteksten til endepunktet ditt. Valider headeren webhook-signature (Standard Webhooks) før du stoler på brødteksten, svar med en 2xx-status innen noen få sekunder, og gjør jobben etterpå. Leveranser til samme endepunkt beholder rekkefølgen på hendelsene; en mislykket leveranse prøves på nytt med stadig lengre pauser.

Nye hendelsestyper og nye felt kan dukke opp når som helst: Hopp over typene og feltene du ikke kjenner.

De samme hendelsene ligger i hendelsesfeeden i 30 dager →