Webhooks
Welcome to theWebhookssection. This article provides a comprehensive overview of this specific technical module.
Webhooks
Welcome to theWebhookssection. This article provides a comprehensive overview of this specific technical module.
Article. created
Triggered when a new article is drafted.
Article. created
Triggered when an article goes live.
Collection. deleted
Triggered when a folder is removed.
search. query
Triggered when a user performs a search.
Payload Structure
All webhook payloads follow a consistent JSON format to make parsing simple.
json
Coppied
1{
2 "event": "article.published",
3 "created_at": 1698154800,
4 data": {
5 "id": "art_123",
6 "title": "Welcome to Lumino",
7 "url": "https://docs.yoursite.com/welcome"
8},
9 "secret_version": "v1"
10}
Security & Verification
Lumino signs every webhook request with anX-Lumino-Signatureheader. You should verify this signature using yourWebhook Secretto ensure the request originated from us.
Verification Steps
- Retrieve the raw request body.
- Extract the signature from the X-Lumino-Signature header.
- Compute a HMAC with the SHA-256 hash function using your secret and the raw body.
- Compare your computed HMAC with the header signature.
Timeout Policy
Your endpoint must return a2xx status codewithin 5 seconds. Failing to do so will result in retries following an exponential backoff strategy.
