Blame
|
1 | # Webhooks |
||||||
| 2 | ||||||||
|
3 | Webhooks notify your systems when AeThex events occur. |
||||||
|
4 | |||||||
|
5 | --- |
||||||
|
6 | |||||||
|
7 | ## Common Events |
||||||
| 8 | ||||||||
| 9 | - passport.created |
|||||||
| 10 | - passport.updated |
|||||||
| 11 | - account.linked |
|||||||
| 12 | - account.unlinked |
|||||||
| 13 | - game.session.started |
|||||||
| 14 | - game.session.completed |
|||||||
| 15 | - locker.item.granted |
|||||||
| 16 | - support.ticket.created |
|||||||
| 17 | - governance.vote.cast |
|||||||
| 18 | ||||||||
| 19 | --- |
|||||||
| 20 | ||||||||
| 21 | ## Security |
|||||||
| 22 | ||||||||
| 23 | Webhook receivers must: |
|||||||
| 24 | ||||||||
| 25 | - Validate signatures. |
|||||||
| 26 | - Reject stale timestamps. |
|||||||
| 27 | - Return quickly. |
|||||||
| 28 | - Process asynchronously. |
|||||||
| 29 | - Make handlers idempotent. |
|||||||
| 30 | ||||||||
| 31 | --- |
|||||||
| 32 | ||||||||
| 33 | ## Example Event |
|||||||
| 34 | ||||||||
| 35 | ```json |
|||||||
| 36 | { |
|||||||
| 37 | "id": "evt_...", |
|||||||
| 38 | "type": "passport.updated", |
|||||||
| 39 | "createdAt": "2026-06-23T00:00:00Z", |
|||||||
| 40 | "data": {} |
|||||||
| 41 | } |
|||||||
| 42 | ``` |
|||||||