Documentation · Endpoints
POST /api/v1/webhooks (Premium)
Enregistrer des endpoints webhook signés HMAC pour alertes Protocol.
Enregistrer
curl -X POST https://getauros.com/api/v1/webhooks \
-H "Authorization: Bearer auros_pk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your.app/hooks/auros",
"events": ["regulation_update", "new_requirement", "regulatory.update", "chargeflow.unit.minted", "chargeflow.unit.retired"]
}'Signature
Chaque payload POST inclut `X-AUROS-Signature: sha256=<hmac>` signé avec `WEBHOOK_SECRET` (côté AUROS).
GET /api/v1/webhooks — liste. DELETE /api/v1/webhooks/:id — suppression.
Événement `regulatory.update` — voir /developers/docs/regulatory-feed.
ChargeFlow : `chargeflow.unit.minted` / `chargeflow.unit.retired` — dispatch à chaque mint/retire sur la même clé API.
Journal des livraisons
Chaque tentative est enregistrée — statuts : pending, delivered, failed, dead_letter (après 5 échecs).
GET /api/v1/webhooks/:id/deliveries?limit=20&offset=0&status=dead_letter — log paginé.
Retry automatique via authenticated monitor jobs — backoff 1m, 5m, 15m, 1h, 4h.
Dashboard premium : /developers/dashboard?key=… — 15 dernières livraisons.
Replay
# Relancer une delivery curl -X POST https://getauros.com/api/v1/webhooks/deliveries/whd_abc123/replay \ -H "Authorization: Bearer auros_pk_live_xxx" # Relancer toutes les dead_letter d'un webhook curl -X POST https://getauros.com/api/v1/webhooks/wh_abc123/replay \ -H "Authorization: Bearer auros_pk_live_xxx"
Payload exemple
{
"event": "regulation_update",
"severity": "high",
"impact_on_score": -8,
"monitor_id": "mon_abc123",
"asset_type": "real_estate",
"jurisdiction": "luxembourg",
"summary": "MiCA CASP authorisation deadline reminder",
"timestamp": "2026-06-11T12:00:00.000Z",
"disclaimer": "Indicative intelligence only..."
}