İçeriğe geç
Sursa Developers

Olaylar · Kaynaklar ve içe aktarma

import.document_failed

Belge içe aktarılamadı

Bir özel kaynağın belgesi içe aktarılmadı ya da dizinlenmedi (data.reason nötr bir koddur).

Nesne türü
source
Teslim edilen webhook’lar
admin rolüne sahip webhook’lar

Veri yükü

Nesne: EventImportDocumentFailed

  • idstringzorunlu

    Olay kimliği (evt_…); webhook-id başlığı olarak da gönderilir. Yinelenen teslimleri ayıklamak için kullanın.

  • typestringzorunlu

    Geçerli değerler: import.document_failed

  • created_atstring (date-time)zorunlu

    Değişikliğin gerçekleştiği zaman (UTC).

  • org_idintegerzorunlu
  • api_versionstringzorunlu

    data şemasının sözleşme sürümü.

  • sequenceinteger

    Webhook içindeki teslim sıra numarası (test olayında yoktur).

  • objectWebhookEventObjectzorunlu
  • payloadstringzorunlu

    thin, data olmadığı anlamına gelir: nesneyi API üzerinden okuyun.

    Geçerli değerler: fullthin

  • dataobject
    Alanlar
    • sourceEventSourcezorunlu
    • documentobjectzorunlu

      Özel kaynak belgesi; gönderim API’sinin belge sonucu da aynı sonucu bildirir.

      Alanlar
      • external_idstring | nullzorunlu
      • titlestring | null
      • card_idstring | nullzorunlu
    • run_idinteger
    • job_idinteger | null

      Dizinleme ya da dışa aktarma işi.

    • reasonstringzorunlu

      Nötr neden kodu (genişletilebilir sabit değer listesi: bilinmeyen bir kodu genel bir hata olarak değerlendirin). Değerler, belge sonuç kodlarıdır: content_invalid, file_rejected, too_large, limit_reached, index_failed.

  • testbooleanzorunlu

    POST /v1/webhooks/{webhook_id}/test ile gönderilen test olayı.

Örnek teslim

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

Olayları alma

Her teslim, bu JSON gövdesiyle webhook’unuzun URL’sine gönderilen bir POST isteğidir. Gövdeye güvenmeden önce webhook-signature başlığını (Standard Webhooks) doğrulayın, birkaç saniye içinde 2xx durumuyla yanıt verin ve işi daha sonra yapın. Bir webhook’a yapılan teslimler olayların sırasını korur; başarısız bir teslim giderek uzayan aralarla yeniden denenir.

Yeni olay türleri ve yeni alanlar her an ortaya çıkabilir: bilmediğiniz türleri ve alanları atlayın.

Aynı olaylar 30 gün boyunca olay beslemesinde de yer alır →