Webhooks
statusChange
yang didukung, khususnya ketika agent masuk ke state ERROR
atau FINISHED
.
Verifikasi webhook
Headers
X-Webhook-Signature
– Berisi signature HMAC-SHA256 dengan formatsha256=<hex_digest>
X-Webhook-ID
– Identifier unik untuk delivery ini (berguna buat logging)X-Webhook-Event
– Jenis event (saat ini hanyastatusChange
)User-Agent
– Selalu di-set keCursor-Agent-Webhook/1.0
Verifikasi signature
Format payload
Praktik terbaik
- Verifikasi signature – Selalu verifikasi signature webhook buat memastikan permintaan itu dari Cursor
- Tangani retry – Webhook bisa dicoba ulang kalau endpoint kamu ngembaliin status code error
- Balas cepat – Balikin status code 2xx secepat mungkin
- Pakai HTTPS – Selalu pakai URL HTTPS buat endpoint webhook di production
- Simpan payload mentah – Simpan payload webhook mentah buat debugging dan verifikasi ke depannya