Συμβάντα · Χρεώσεις
subscription.updated
Η συνδρομή ενημερώθηκε
Η συνδρομή cloud άλλαξε: έκδοση (edition), κατάσταση, θέσεις ή περίοδος (το data.previous_attributes περιέχει τις προηγούμενες τιμές).
- Τύπος αντικειμένου
- subscription
- Παραλήπτες
- Τα webhooks με τον ρόλο admin
Σώμα παράδοσης
Αντικείμενο: EventSubscriptionUpdated
idstringυποχρεωτικόID του συμβάντος (
evt_…), που στέλνεται επίσης ως κεφαλίδαwebhook-id. Χρησιμοποιήστε το για να απορρίπτετε διπλές παραδόσεις.typestringυποχρεωτικόΕπιτρεπόμενες τιμές:
subscription.updatedcreated_atstring (date-time)υποχρεωτικόΠότε συνέβη η αλλαγή (UTC).
org_idintegerυποχρεωτικόapi_versionstringυποχρεωτικόΈκδοση συμβολαίου του σχήματος
data.sequenceintegerΑύξων αριθμός της παράδοσης στο πλαίσιο του webhook (λείπει για δοκιμαστικό συμβάν).
payloadstringυποχρεωτικόΤο
thinσημαίνει χωρίςdata: διαβάστε το αντικείμενο μέσω του API.Επιτρεπόμενες τιμές:
fullthindataobjectΠεδία
previous_attributesobjectυποχρεωτικόΠροηγούμενες τιμές των πεδίων ανώτατου επιπέδου του αντικειμένου που άλλαξαν.
actor_idinteger | nullυποχρεωτικόΟ χρήστης που εκτέλεσε την ενέργεια·
nullγια ένα κλειδί API του οργανισμού ή για την ίδια την πλατφόρμα.
testbooleanυποχρεωτικόΈνα δοκιμαστικό συμβάν που στάλθηκε με
POST /v1/webhooks/{webhook_id}/test.
Παράδειγμα παράδοσης
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "subscription.updated",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "subscription",
"id": "1"
},
"payload": "full",
"data": {
"subscription": {
"edition": "business",
"status": "active",
"seats_purchased": 25,
"billing_interval": "month",
"trial_ends_at": null,
"current_period_start": "2026-10-01T00:00:00Z",
"current_period_end": "2026-11-01T00:00:00Z",
"canceled_at": null,
"credits_allowance": 5000
},
"previous_attributes": {
"seats_purchased": 20
},
"actor_id": 7
},
"test": false
}Λήψη συμβάντων
Κάθε παράδοση είναι ένα αίτημα POST με αυτό το σώμα JSON προς τη διεύθυνση παραλήπτη σας. Επαληθεύστε την κεφαλίδα webhook-signature (Standard Webhooks) πριν εμπιστευτείτε το σώμα, επιστρέψτε κατάσταση 2xx μέσα σε λίγα δευτερόλεπτα και κάντε την επεξεργασία μετά. Οι παραδόσεις προς ένα webhook διατηρούν τη σειρά των συμβάντων· μια αποτυχημένη παράδοση επαναλαμβάνεται με αυξανόμενες παύσεις.
Νέοι τύποι συμβάντων και νέα πεδία μπορεί να εμφανιστούν ανά πάσα στιγμή: παραλείψτε τους τύπους και τα πεδία που δεν γνωρίζετε.
Τα ίδια συμβάντα βρίσκονται στην τροφοδοσία συμβάντων για 30 ημέρες →