Webhooks
En bref
Les webhooks se configurent dans l'espace développeur authentifié (Starter+). Payload JSON signé, retry automatique.
Configuration
Rendez-vous sur https://app.askmarcel.app/developers, onglet Webhooks. Ajoutez une URL HTTPS de votre serveur. Un secret de signature vous est fourni pour vérifier l'authenticité.
Palier requis
Les webhooks sont disponibles à partir du palier Starter (production autorisée).
Événements
- diagnostic.completed — diagnostic sourcé terminé avec succès
- quota.warning — seuil d'enveloppe atteint (80 %)
- quota.exceeded — enveloppe épuisée
Format du payload
Exemple diagnostic.completed
{
"event": "diagnostic.completed",
"timestamp": "2026-08-09T12:00:00Z",
"data": {
"brand": "Mitsubishi",
"error_code": "E7",
"confidence": "high",
"chunk_id": "chk_abc123"
}
}Sécurité
- Header X-AM-Signature : HMAC-SHA256 du body avec votre secret
- Vérifiez la signature avant de traiter l'événement
- Répondez 2xx sous 10 s — sinon retry exponentiel (3 tentatives)