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

Συμβάντα · Συνεργασία

announcement.read

Η ανακοίνωση διαβάστηκε

Ένας παραλήπτης επιβεβαίωσε την ανάγνωση μιας ανακοίνωσης υποχρεωτικής ανάγνωσης.

Τύπος αντικειμένου
announcement
Παραλήπτες
Τα webhooks που βλέπουν το αντικείμενο: ανάλογα με τον ρόλο, το προφίλ δεδομένων και τις συλλογές

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

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

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

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

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

    Επιτρεπόμενες τιμές: announcement.read

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

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

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

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

  • sequenceinteger

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

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

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

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

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

      Ποιος επιβεβαίωσε την ανάγνωση.

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

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

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

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "announcement.read",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "announcement",
    "id": "12"
  },
  "payload": "full",
  "data": {
    "announcement": {
      "id": 12,
      "card_id": "c_9f2e41"
    },
    "user_id": 11
  },
  "test": false
}

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

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

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

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