Hændelser · Fakturering

credits.low

Få credits tilbage

Saldoen af credits for perioden har passeret en tærskel for forbrug (data.threshold, procent af forbrugsrammen, der er brugt). Sendes én gang pr. tærskel og periode.

Objekttype: org
Leveres til: Slutpunkter med rollen admin

Payload

Objekt: EventCreditsLow

idstringpåkrævet
Hændelsens id (evt_…), sendes også som headeren webhook-id. Brug det til at frasortere dobbelte leveringer.
typestringpåkrævet
Tilladte værdier: credits.low
created_atstring (date-time)påkrævet
Tidspunkt, hvor ændringen skete (UTC).
org_idintegerpåkrævet
api_versionstringpåkrævet
Kontraktversion for skemaet data.
sequenceinteger
Leveringens løbenummer inden for slutpunktet (mangler for en testhændelse).
objectWebhookEventObjectpåkrævet
payloadstringpåkrævet
thin betyder ingen data: læs objektet via API’et.
Tilladte værdier: fullthin
dataobject
Felter
- thresholdintegerpåkrævet
  Tærskel i procent af den brugte forbrugsramme: 80 eller 100.
- period_startstring (date)påkrævet
- balancenumber
- allowancenumber
testbooleanpåkrævet
En testhændelse sendt af POST /v1/webhooks/{webhook_id}/test.

Eksempel på levering

{
  "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
}

Modtag hændelser

Hver levering er en POST-anmodning med denne JSON-brødtekst til dit slutpunkt. Validér headeren webhook-signature (Standard Webhooks), før du stoler på brødteksten, svar med en 2xx-status inden for få sekunder, og udfør arbejdet bagefter. Leveringer til samme slutpunkt bevarer hændelsernes rækkefølge; en mislykket levering forsøges igen med stadig længere pauser.

Nye hændelsestyper og nye felter kan dukke op når som helst: Spring de typer og felter over, som du ikke kender.

De samme hændelser ligger i hændelsesfeedet i 30 dage →