Integrations

Cette section documente les contrats techniques exposes publiquement: catalogue API JSON, connecteurs actifs et webhook entrant.

Endpoints publies

/api/v1/openapi.json
/api/v1/integrations/index.json
/api/v1/connectors/index.json
/api/v1/ai/quality-kit.json
/api/v1/webhooks/device-signal.schema.json

Connecteurs supportes

Connecteur	Sens	Authentification	Endpoint	Usage
GoatCounter	outbound	vhost-scoped	`https://analytics.leandro-sierra.com/count.js`	Injection du script de mesure d'audience GoatCounter (compteur par vhost).
FormSubmit	outbound	none	`https://formsubmit.co/ajax/contact@leandro-sierra.com`	Envoi des messages du formulaire contact vers la boite support produit.
Google AdSense	outbound	adsense-client-id	`https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js`	Active les emplacements publicitaires uniquement avec IDs approuves.
DeviceSignalWebhook	inbound	x-webhook-signature	`/api/v1/webhooks/device-signal`	Endpoint HTTP 202 pour valider le contrat webhook d'integration.

Webhook entrant device-signal

Endpoint HTTP: /api/v1/webhooks/device-signal (POST).
Reponse immediate 202 avec accusé de contrat mode contract-ack.
Payload valide par le schema JSON: /api/v1/webhooks/device-signal.schema.json.
OpenAPI complet disponible sur /api/v1/openapi.json.

{
  "event": "device.signal.detected",
  "event_id": "evt_01JZ8F2T6B5D2V5W9E5M2T3N5Q",
  "occurred_at": "2026-06-01T09:15:00Z",
  "source": "vendor-status-monitor",
  "device": {
    "slug": "nest-secure",
    "brand": "Google",
    "model": "Nest Secure"
  },
  "signal": {
    "type": "support_end",
    "severity": "high",
    "summary": "Vendor support page marks the product as discontinued."
  },
  "evidence_url": "https://support.google.com/googlenest/answer/10191961",
  "locale": "en"
}