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