CaledoLegales
API V1

Webhooks CaledoLegales

Recevez les events JONC, surveillances et reformes en push HTTP vers votre endpoint. Signes HMAC SHA256, retry exponentiel, livraison garantie 99,5%.

Events disponibles

EventQuandPlan min
annonce.createdNouvelle annonce JONC publieePro
entreprise.updatedFiche entreprise modifiee (gerance, capital, siege)Pro
watch.triggeredSurveillance RIDET detecte une annoncePro
procedure.openedProcedure collective ouverte (sauvegarde/RJ/LJ)Pro
reform.publishedLoi du pays ou delibe province adopteePro
sanction.acncSanction ACNC ou CNIL-NC publieeEquipe

Verification HMAC SHA256

Chaque webhook est signe avec votre secret. Verifier avant de traiter:

# Header HTTP envoye:
X-CaledoLegales-Signature: t=1715587200,v1=5e1b2c8a9d3f...

# Verification Node.js:
const crypto = require('crypto');
function verify(payload, header, secret) {
  const [t, v1] = header.split(',').map(p => p.split('=')[1]);
  const signedPayload = \u0060\u0024{t}.\u0024{payload}\u0060;
  const expected = crypto.createHmac('sha256', secret).update(signedPayload).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

Payload type

{
  "event": "annonce.created",
  "id": "evt_1k2j3h4k5l6m",
  "timestamp": 1715587200,
  "data": {
    "annonce_id": "an_aBc123",
    "ridet": "1648294001",
    "denomination": "DEEP EVENTS SARL",
    "type": "changement_gerant",
    "date_publication": "2026-05-13",
    "source": "JONC",
    "resume_ia": "Nomination de M. X aux fonctions de gerant..."
  },
  "api_version": "v1"
}

Retry policy

Initial

POST immediate. Timeout 30s. Reponse attendue: 2xx HTTP status.

Retry 1

+1 min apres echec. Memes en-tetes (idempotency_key inchangee).

Retry 2-5

Backoff exponentiel: 5min / 15min / 1h / 6h.

Apres 6 echecs

Webhook desactive automatiquement. Email envoye. Reactivation manuelle dans le dashboard.

Tester votre endpoint