Μετάβαση στο περιεχόμενο
Sursa Developers

Συμβάντα · Πηγές και εισαγωγή

import.document_failed

Η εισαγωγή εγγράφου απέτυχε

Ένα έγγραφο μιας προσαρμοσμένης πηγής δεν εισήχθη ή δεν ευρετηριάστηκε (το data.reason είναι ουδέτερος κωδικός).

Τύπος αντικειμένου
source
Παραλήπτες
Τα webhooks με τον ρόλο admin

Σώμα παράδοσης

Αντικείμενο: EventImportDocumentFailed

  • idstringυποχρεωτικό

    ID του συμβάντος (evt_…), που στέλνεται επίσης ως κεφαλίδα webhook-id. Χρησιμοποιήστε το για να απορρίπτετε διπλές παραδόσεις.

  • typestringυποχρεωτικό

    Επιτρεπόμενες τιμές: import.document_failed

  • created_atstring (date-time)υποχρεωτικό

    Πότε συνέβη η αλλαγή (UTC).

  • org_idintegerυποχρεωτικό
  • api_versionstringυποχρεωτικό

    Έκδοση συμβολαίου του σχήματος data.

  • sequenceinteger

    Αύξων αριθμός της παράδοσης στο πλαίσιο του webhook (λείπει για δοκιμαστικό συμβάν).

  • objectWebhookEventObjectυποχρεωτικό
  • payloadstringυποχρεωτικό

    Το thin σημαίνει χωρίς data: διαβάστε το αντικείμενο μέσω του API.

    Επιτρεπόμενες τιμές: fullthin

  • dataobject
    Πεδία
    • sourceEventSourceυποχρεωτικό
    • documentobjectυποχρεωτικό

      Το έγγραφο της προσαρμοσμένης πηγής· το αποτέλεσμα εγγράφου του API αποστολής αναφέρει την ίδια έκβαση.

      Πεδία
      • external_idstring | nullυποχρεωτικό
      • titlestring | null
      • card_idstring | nullυποχρεωτικό
    • run_idinteger
    • job_idinteger | null

      Η εργασία ευρετηρίασης ή εξαγωγής.

    • reasonstringυποχρεωτικό

      Ουδέτερος κωδικός λόγου (επεκτάσιμη απαρίθμηση: θεωρήστε έναν άγνωστο κωδικό γενική αποτυχία). Οι τιμές είναι κωδικοί έκβασης εγγράφου: content_invalid, file_rejected, too_large, limit_reached, index_failed.

  • testbooleanυποχρεωτικό

    Ένα δοκιμαστικό συμβάν που στάλθηκε με POST /v1/webhooks/{webhook_id}/test.

Παράδειγμα παράδοσης

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

Λήψη συμβάντων

Κάθε παράδοση είναι ένα αίτημα POST με αυτό το σώμα JSON προς τη διεύθυνση παραλήπτη σας. Επαληθεύστε την κεφαλίδα webhook-signature (Standard Webhooks) πριν εμπιστευτείτε το σώμα, επιστρέψτε κατάσταση 2xx μέσα σε λίγα δευτερόλεπτα και κάντε την επεξεργασία μετά. Οι παραδόσεις προς ένα webhook διατηρούν τη σειρά των συμβάντων· μια αποτυχημένη παράδοση επαναλαμβάνεται με αυξανόμενες παύσεις.

Νέοι τύποι συμβάντων και νέα πεδία μπορεί να εμφανιστούν ανά πάσα στιγμή: παραλείψτε τους τύπους και τα πεδία που δεν γνωρίζετε.

Τα ίδια συμβάντα βρίσκονται στην τροφοδοσία συμβάντων για 30 ημέρες →