Gå til indholdet
Sursa Developers

Hændelser · Kort

card.updated

Kort opdateret

Kortets felter eller indhold blev ændret: en ændring af kortets stamdata, tags, ejer, en ny version af filen eller teksten, et udkast, der er publiceret som en ny version, eller at behandlingen har tildelt kortet dets adgangskategori (data.previous_attributes.category _unclassified – kortet ventede på klassificering og er nu tilgængeligt for modtagere, hvis dataprofil giver adgang til kortets kategori). data.previous_attributes indeholder de tidligere værdier af de ændrede felter.

Objekttype
card
Leveres til
Slutpunkter, der kan se objektet: efter rolle, dataprofil og samlinger

Payload

Objekt: EventCardUpdated

  • 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: card.updated

  • 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
    • cardEventCardpåkrævet
    • actor_idinteger | nullpåkrævet

      Den bruger, der udførte handlingen; null for en organisations API-nøgle eller platformen selv.

    • previous_attributesobjectpåkrævet

      Tidligere værdier af objektets ændrede felter på øverste niveau.

    • job_idinteger | null

      Indekserings- eller eksportjobbet.

    • verified_on_publishboolean

      Udkastet blev publiceret som verificeret.

  • testbooleanpåkrævet

    En testhændelse sendt af POST /v1/webhooks/{webhook_id}/test.

Eksempel på levering

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "card.updated",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "card",
    "id": "c_9f2e41"
  },
  "payload": "full",
  "data": {
    "card": {
      "id": "c_9f2e41",
      "title": "Refund policy",
      "collection": "support",
      "collection_id": 3,
      "version": 4,
      "kind": "text",
      "status": "ready",
      "verification_state": "trusted",
      "owner_id": 7,
      "tags": [
        "billing"
      ],
      "external_id": null,
      "metadata": {}
    },
    "actor_id": 7,
    "previous_attributes": {
      "title": "Refunds"
    }
  },
  "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 →