Gå til indholdet
Sursa Developers

Hændelser · Kilder og import

import.document_failed

Import af dokument mislykkedes

Et dokument fra en brugerdefineret kilde blev ikke importeret eller ikke indekseret (data.reason er en neutral kode).

Objekttype
source
Leveres til
Slutpunkter med rollen admin

Payload

Objekt: EventImportDocumentFailed

  • 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: import.document_failed

  • 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
    • sourceEventSourcepåkrævet
    • documentobjectpåkrævet

      Dokumentet i den brugerdefinerede kilde; dokumentresultatet fra push-API’et viser det samme udfald.

      Felter
      • external_idstring | nullpåkrævet
      • titlestring | null
      • card_idstring | nullpåkrævet
    • run_idinteger
    • job_idinteger | null

      Indekserings- eller eksportjobbet.

    • reasonstringpåkrævet

      Neutral årsagskode (udvidelig enum: behandl en ukendt kode som en generel fejl). Værdierne er koder for dokumentets udfald: content_invalid, file_rejected, too_large, limit_reached, index_failed.

  • testbooleanpåkrævet

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

Eksempel på levering

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "import.document_failed",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "source",
    "id": "5"
  },
  "payload": "full",
  "data": {
    "source": {
      "id": 5,
      "name": "Help center",
      "kind": "custom",
      "collection_id": 3
    },
    "document": {
      "external_id": "kb-article-118",
      "title": "Shipping rates",
      "card_id": null
    },
    "run_id": 902,
    "reason": "content_invalid"
  },
  "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 →