Συμβάντα · Πηγές και εισαγωγή
import.document_failed
Η εισαγωγή εγγράφου απέτυχε
Ένα έγγραφο μιας προσαρμοσμένης πηγής δεν εισήχθη ή δεν ευρετηριάστηκε (το data.reason είναι ουδέτερος κωδικός).
- Τύπος αντικειμένου
- source
- Παραλήπτες
- Τα webhooks με τον ρόλο admin
Σώμα παράδοσης
Αντικείμενο: EventImportDocumentFailed
idstringυποχρεωτικόID του συμβάντος (
evt_…), που στέλνεται επίσης ως κεφαλίδαwebhook-id. Χρησιμοποιήστε το για να απορρίπτετε διπλές παραδόσεις.typestringυποχρεωτικόΕπιτρεπόμενες τιμές:
import.document_failedcreated_atstring (date-time)υποχρεωτικόΠότε συνέβη η αλλαγή (UTC).
org_idintegerυποχρεωτικόapi_versionstringυποχρεωτικόΈκδοση συμβολαίου του σχήματος
data.sequenceintegerΑύξων αριθμός της παράδοσης στο πλαίσιο του webhook (λείπει για δοκιμαστικό συμβάν).
payloadstringυποχρεωτικόΤο
thinσημαίνει χωρίςdata: διαβάστε το αντικείμενο μέσω του API.Επιτρεπόμενες τιμές:
fullthindataobjectΠεδία
documentobjectυποχρεωτικόΤο έγγραφο της προσαρμοσμένης πηγής· το αποτέλεσμα εγγράφου του API αποστολής αναφέρει την ίδια έκβαση.
Πεδία
external_idstring | nullυποχρεωτικόtitlestring | nullcard_idstring | nullυποχρεωτικό
run_idintegerjob_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 ημέρες →