Preskoči na sadržaj
Sursa Developers

Događaji · Kartice

card.index_failed

Indeksiranje kartice nije uspjelo

Indeksiranje verzije kartice nije uspjelo (data.reason je neutralni kod). Kartica zadržava status pogreške dok se ponovno ne učita ili ponovno ne indeksira.

Vrsta objekta
card
Primatelji
Webhookovi koji vide objekt: prema ulozi, podatkovnom profilu i zbirkama

Tijelo isporuke

Objekt: EventCardIndexFailed

  • idstringobavezno

    ID događaja (evt_…), šalje se i kao zaglavlje webhook-id. Koristite ga za odbacivanje dupliciranih isporuka.

  • typestringobavezno

    Dopuštene vrijednosti: card.index_failed

  • created_atstring (date-time)obavezno

    Kada se promjena dogodila (UTC).

  • org_idintegerobavezno
  • api_versionstringobavezno

    Verzija ugovora sheme data.

  • sequenceinteger

    Redni broj isporuke unutar webhooka (nema ga za probni događaj).

  • objectWebhookEventObjectobavezno
  • payloadstringobavezno

    thin znači bez data: objekt pročitajte putem API-ja.

    Dopuštene vrijednosti: fullthin

  • dataobject
    Polja
    • cardEventCardobavezno
    • job_idinteger | null

      Posao indeksiranja ili izvoza.

    • versionintegerobavezno
    • reasonstringobavezno

      Neutralni kod razloga (proširivo nabrajanje: nepoznat kod tretirajte kao općeniti neuspjeh). Primjeri: unprocessable, too_large, timeout, upstream_unavailable, internal.

  • testbooleanobavezno

    Probni događaj poslan putem POST /v1/webhooks/{webhook_id}/test.

Primjer isporuke

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

Primanje događaja

Svaka isporuka je POST zahtjev s ovim JSON tijelom na adresu vašeg webhooka. Provjerite zaglavlje webhook-signature (Standard Webhooks) prije nego što se pouzdate u tijelo, odgovorite statusom 2xx u roku od nekoliko sekundi, a posao obavite nakon toga. Isporuke jednom webhooku čuvaju redoslijed događaja; neuspjela isporuka ponavlja se sa sve duljim stankama.

Nove vrste događaja i nova polja mogu se pojaviti u bilo kojem trenutku: preskočite vrste i polja koja ne poznajete.

Isti su događaji 30 dana dostupni u feedu događaja →