Přejít na obsah
Sursa Developers

Události · Karty

card.index_failed

Indexování karty selhalo

Indexování verze karty selhalo (data.reason je neutrální kód). Karta si ponechá chybový stav, dokud nebude znovu nahrána nebo znovu zaindexována.

Typ objektu
card
Komu se doručuje
Webhookům, které objekt vidí: podle role, datového profilu a kolekcí

Obsah události

Objekt: EventCardIndexFailed

  • idstringpovinné

    ID události (evt_…), posílá se také jako hlavička webhook-id. Podle něj zahazujte duplicitní doručení.

  • typestringpovinné

    Povolené hodnoty: card.index_failed

  • created_atstring (date-time)povinné

    Kdy ke změně došlo (UTC).

  • org_idintegerpovinné
  • api_versionstringpovinné

    Verze kontraktu schématu data.

  • sequenceinteger

    Pořadové číslo doručení v rámci webhooku (u testovací události chybí).

  • objectWebhookEventObjectpovinné
  • payloadstringpovinné

    thin znamená bez data: objekt si přečtěte přes API.

    Povolené hodnoty: fullthin

  • dataobject
    Pole
    • cardEventCardpovinné
    • job_idinteger | null

      Úloha indexování nebo exportu.

    • versionintegerpovinné
    • reasonstringpovinné

      Neutrální kód důvodu (rozšiřitelný výčet: neznámý kód považujte za obecné selhání). Příklady: unprocessable, too_large, timeout, upstream_unavailable, internal.

  • testbooleanpovinné

    Testovací událost odeslaná pomocí POST /v1/webhooks/{webhook_id}/test.

Ukázka doručení

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

Příjem událostí

Každé doručení je požadavek POST s tímto tělem JSON na adresu vašeho příjemce. Než tělu začnete důvěřovat, ověřte hlavičku webhook-signature (Standard Webhooks), do několika sekund odpovězte stavovým kódem 2xx a samotnou práci udělejte až potom. Doručení na jeden webhook zachovávají pořadí událostí; neúspěšné doručení se opakuje s rostoucími pauzami.

Nové typy událostí a nová pole se mohou objevit kdykoli: typy a pole, které neznáte, přeskočte.

Stejné události najdete 30 dní v kanálu událostí →