Documentation Index
Fetch the complete documentation index at: https://docs.kiriku.app/llms.txt
Use this file to discover all available pages before exploring further.
Kiriku envoie des webhooks pour les extractions et les tests de webhook.
Événements disponibles
extraction.completed
extraction.failed
webhook.test
En-têtes envoyés
X-Kiriku-Signature: HMAC SHA-256 du body brut
X-Kiriku-Event: nom de l’événement
Vérifier la signature
Utilisez le secret généré lors de la création du webhook.
import crypto from 'crypto';
app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
const signature = req.headers['x-kiriku-signature'];
const payload = req.body;
const secret = process.env.KIRIKU_WEBHOOK_SECRET;
const expected = crypto
.createHmac('sha256', secret)
.update(payload)
.digest('hex');
if (signature !== expected) {
return res.status(401).send('Invalid signature');
}
// Process event
res.status(200).send('ok');
});
Payload type
{
"event": "extraction.completed",
"apiVersion": "2025-06-01",
"id": "evt_...",
"createdAt": "2026-03-12T12:00:00.000Z",
"data": {
"extractionId": "ext_...",
"status": "completed",
"result": { }
}
}
Webhooks billing (DexPay)
Les webhooks DexPay sont reçus sur POST /v1/billing/webhook et vérifiés avec x-webhook-signature.