Συμβάντα · Εργασίες και εξαγωγές
export.ready
Η εξαγωγή είναι έτοιμη
Ένα αρχείο εξαγωγής είναι έτοιμο για λήψη: εξαγωγή κάρτας, εξαγωγή του οργανισμού ή αρχείο που δημιουργήθηκε ξανά.
- Τύπος αντικειμένου
- file
- Παραλήπτες
- Τα webhooks με τον ρόλο admin
Σώμα παράδοσης
idstringυποχρεωτικόID του συμβάντος (
evt_…), που στέλνεται επίσης ως κεφαλίδαwebhook-id. Χρησιμοποιήστε το για να απορρίπτετε διπλές παραδόσεις.typestringυποχρεωτικόΕπιτρεπόμενες τιμές:
export.readycreated_atstring (date-time)υποχρεωτικόΠότε συνέβη η αλλαγή (UTC).
org_idintegerυποχρεωτικόapi_versionstringυποχρεωτικόΈκδοση συμβολαίου του σχήματος
data.sequenceintegerΑύξων αριθμός της παράδοσης στο πλαίσιο του webhook (λείπει για δοκιμαστικό συμβάν).
payloadstringυποχρεωτικόΤο
thinσημαίνει χωρίςdata: διαβάστε το αντικείμενο μέσω του API.Επιτρεπόμενες τιμές:
fullthindataobjectΠεδία
kindstringυποχρεωτικόΤι εξήχθη:
cards,answer,card,report,org…job_idinteger | nullΗ εργασία ευρετηρίασης ή εξαγωγής.
actor_idinteger | nullυποχρεωτικόΟ χρήστης που εκτέλεσε την ενέργεια·
nullγια ένα κλειδί API του οργανισμού ή για την ίδια την πλατφόρμα.regeneratedbooleanΤο αρχείο δημιουργήθηκε ξανά (
POST /v1/files/{file_id}/regenerate).
testbooleanυποχρεωτικόΈνα δοκιμαστικό συμβάν που στάλθηκε με
POST /v1/webhooks/{webhook_id}/test.
Παράδειγμα παράδοσης
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "export.ready",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "file",
"id": "f2b1c0de-0000-4000-8000-000000000001"
},
"payload": "full",
"data": {
"file": {
"id": "f2b1c0de-0000-4000-8000-000000000001",
"filename": "cards.xlsx",
"format": "xlsx",
"size": 18234,
"expires_at": "2026-10-31T10:00:00Z"
},
"kind": "cards",
"job_id": null,
"actor_id": 7
},
"test": false
}Λήψη συμβάντων
Κάθε παράδοση είναι ένα αίτημα POST με αυτό το σώμα JSON προς τη διεύθυνση παραλήπτη σας. Επαληθεύστε την κεφαλίδα webhook-signature (Standard Webhooks) πριν εμπιστευτείτε το σώμα, επιστρέψτε κατάσταση 2xx μέσα σε λίγα δευτερόλεπτα και κάντε την επεξεργασία μετά. Οι παραδόσεις προς ένα webhook διατηρούν τη σειρά των συμβάντων· μια αποτυχημένη παράδοση επαναλαμβάνεται με αυξανόμενες παύσεις.
Νέοι τύποι συμβάντων και νέα πεδία μπορεί να εμφανιστούν ανά πάσα στιγμή: παραλείψτε τους τύπους και τα πεδία που δεν γνωρίζετε.
Τα ίδια συμβάντα βρίσκονται στην τροφοδοσία συμβάντων για 30 ημέρες →