Mine sisu juurde
Sursa Developers

Sündmused · Kaardid

card.index_failed

Kaardi indekseerimine nurjus

Kaardi versiooni indekseerimine nurjus (data.reason on neutraalne kood). Kaardil jääb vea olek, kuni see uuesti üles laaditakse või uuesti indekseeritakse.

Objekti tüüp
card
Vastuvõtvad veebihaagid
Veebihaagid, mis objekti näevad: rolli, andmeprofiili ja kogude järgi

Sisu

Objekt: EventCardIndexFailed

  • idstringkohustuslik

    Sündmuse ID (evt_…), mis saadetakse ka päisena webhook-id. Kasutage seda topeltedastuste kõrvaldamiseks.

  • typestringkohustuslik

    Lubatud väärtused: card.index_failed

  • created_atstring (date-time)kohustuslik

    Millal muudatus toimus (UTC).

  • org_idintegerkohustuslik
  • api_versionstringkohustuslik

    Skeemi data lepingu versioon.

  • sequenceinteger

    Edastuse järjekorranumber veebihaagi piires (testsündmuse puhul puudub).

  • objectWebhookEventObjectkohustuslik
  • payloadstringkohustuslik

    thin tähendab, et välja data ei ole: lugege objekti API kaudu.

    Lubatud väärtused: fullthin

  • dataobject
    Väljad
    • cardEventCardkohustuslik
    • job_idinteger | null

      Indekseerimis- või eksporditöö.

    • versionintegerkohustuslik
    • reasonstringkohustuslik

      Neutraalne põhjuse kood (laiendatav loend: käsitlege tundmatut koodi üldise tõrkena). Näited: unprocessable, too_large, timeout, upstream_unavailable, internal.

  • testbooleankohustuslik

    Testsündmus, mille saatis POST /v1/webhooks/{webhook_id}/test.

Näidisedastus

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "card.index_failed",
  "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": "error",
      "verification_state": "trusted",
      "owner_id": 7,
      "tags": [
        "billing"
      ],
      "external_id": null,
      "metadata": {}
    },
    "job_id": 4410,
    "version": 4,
    "reason": "unprocessable"
  },
  "test": false
}

Sündmuste vastuvõtmine

Iga edastus on selle JSON-kehaga POST-päring teie veebihaagi URL-ile. Enne keha usaldamist kontrollige päist webhook-signature (Standard Webhooks), vastake mõne sekundi jooksul olekuga 2xx ja tehke töö ära hiljem. Ühe veebihaagi edastused säilitavad sündmuste järjekorra; ebaõnnestunud edastust proovitakse uuesti üha pikemate vahedega.

Uued sündmusetüübid ja uued väljad võivad ilmuda igal ajal: jätke tundmatud tüübid ja väljad vahele.

Samad sündmused on 30 päeva jooksul sündmuste lindis →