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

Συμβάντα · Εργασίες και εξαγωγές

export.ready

Η εξαγωγή είναι έτοιμη

Ένα αρχείο εξαγωγής είναι έτοιμο για λήψη: εξαγωγή κάρτας, εξαγωγή του οργανισμού ή αρχείο που δημιουργήθηκε ξανά.

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

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

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

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

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

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

    Επιτρεπόμενες τιμές: export.ready

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

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

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

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

  • sequenceinteger

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

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

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

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

  • dataobject
    Πεδία
    • fileEventFileυποχρεωτικό
    • 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 ημέρες →