Συμβάντα · Συμβάντα υπηρεσίας webhook
webhook.ping
Δοκιμαστικό συμβάν
Δοκιμαστικό συμβάν που στέλνεται με το POST /v1/webhooks/{webhook_id}/test. Δεν είναι δυνατή η συνδρομή σε αυτό, και δεν καταγράφεται στην τροφοδοσία συμβάντων.
- Τύπος αντικειμένου
- webhook
- Παραλήπτες
- Τα webhooks με τον ρόλο admin
Σώμα παράδοσης
idstringυποχρεωτικόID του συμβάντος (
evt_…), που στέλνεται επίσης ως κεφαλίδαwebhook-id. Χρησιμοποιήστε το για να απορρίπτετε διπλές παραδόσεις.typestringυποχρεωτικόΕπιτρεπόμενες τιμές:
webhook.pingcreated_atstring (date-time)υποχρεωτικόΠότε συνέβη η αλλαγή (UTC).
org_idintegerυποχρεωτικόapi_versionstringυποχρεωτικόΈκδοση συμβολαίου του σχήματος
data.sequenceintegerΑύξων αριθμός της παράδοσης στο πλαίσιο του webhook (λείπει για δοκιμαστικό συμβάν).
payloadstringυποχρεωτικόΤο
thinσημαίνει χωρίςdata: διαβάστε το αντικείμενο μέσω του API.Επιτρεπόμενες τιμές:
fullthindataobjectΠεδία
endpoint_idintegerυποχρεωτικόmessagestringυποχρεωτικόrequested_byinteger | null
testbooleanυποχρεωτικόΈνα δοκιμαστικό συμβάν που στάλθηκε με
POST /v1/webhooks/{webhook_id}/test.
Παράδειγμα παράδοσης
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "webhook.ping",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"object": {
"type": "webhook",
"id": "4"
},
"payload": "full",
"data": {
"endpoint_id": 4,
"message": "Test event from the knowledge platform",
"requested_by": 7
},
"test": true
}Λήψη συμβάντων
Κάθε παράδοση είναι ένα αίτημα POST με αυτό το σώμα JSON προς τη διεύθυνση παραλήπτη σας. Επαληθεύστε την κεφαλίδα webhook-signature (Standard Webhooks) πριν εμπιστευτείτε το σώμα, επιστρέψτε κατάσταση 2xx μέσα σε λίγα δευτερόλεπτα και κάντε την επεξεργασία μετά. Οι παραδόσεις προς ένα webhook διατηρούν τη σειρά των συμβάντων· μια αποτυχημένη παράδοση επαναλαμβάνεται με αυξανόμενες παύσεις.
Νέοι τύποι συμβάντων και νέα πεδία μπορεί να εμφανιστούν ανά πάσα στιγμή: παραλείψτε τους τύπους και τα πεδία που δεν γνωρίζετε.
Τα ίδια συμβάντα βρίσκονται στην τροφοδοσία συμβάντων για 30 ημέρες →