Vai al contenuto principale

Preventivo in 24 ore

N. Verde
Analisi Legionella Italia
Preventivo
Developer hub

API & WEBHOOKS PER SVILUPPATORI

Integra 123legionella nel tuo CRM, dashboard o tool di automation. API open CC BY 4.0, webhooks firmati HMAC SHA-256, template pronti per Zapier, Make e n8n. Zero setup, rate limit trasparenti.

Documentazione APIRegistra un webhook

API pubbliche

Dataset aperti su incidenza Legionella per regione, città, anno. Licenza Creative Commons CC BY 4.0 — citazione obbligatoria, uso commerciale ammesso.

  • GET /api/v1/legionella/regioni

    Casi notificati per le 20 regioni italiane.

  • GET /api/v1/legionella/regioni/[slug]

    Dettaglio singola regione + storico.

Vedi la documentazione completa →

Webhooks

Ricevi eventi in tempo reale sul tuo endpoint HTTPS. Ogni payload è firmato HMAC SHA-256 con il tuo secret — header X-123Legionella-Signature.

Eventi disponibili

  • lead.created

    Nuovo lead acquisito da form preventivo o landing.

  • order.created

    Nuovo ordine creato (pre-pagamento).

  • order.paid

    Ordine confermato come pagato (bonifico ricevuto).

  • directory.approved

    Struttura della Directory approvata e pubblicata.

  • ambassador.approved

    Candidatura ambassador approvata, badge attivo.

  • press_release.published

    Press release pubblicata nella press room.

  • report.published

    Report annuale Osservatorio rilasciato.

Come iscriversi

  1. 1. Compila il form su /sviluppatori/webhook-subscribe con URL endpoint, email referente e gli eventi che vuoi ricevere.
  2. 2. Riceverai un secret HMAC (mostrato una sola volta — salvalo subito).
  3. 3. Verifica la firma di ogni richiesta: HMAC_SHA256(secret, body) deve uguagliare l'header X-123Legionella-Signature (rimuovi il prefisso sha256=).
  4. 4. Rispondi 2xx entro 8 secondi. Altrimenti retry automatico 3 volte con backoff esponenziale, poi cron retry ogni 15 minuti.

Esempi di integrazione

Test webhook delivery

Una volta registrato, puoi triggerare un evento di prova chiamando l'endpoint:

curl -X POST https://123legionella.com/api/sviluppatori/webhook-test \
  -H "Content-Type: application/json" \
  -d '{"event":"lead.created"}'

Rate limit: 3 chiamate/minuto per IP. Verrà inviato un payload sample con test: true.

Rate limits & retry policy

Rate limits API pubbliche
  • • /api/v1/* — 60 richieste / minuto per IP
  • • /api/sviluppatori/webhook-subscribe — 5 / minuto per IP
  • • /api/sviluppatori/webhook-test — 3 / minuto per IP
Retry policy webhook
  • • 3 retry inline con backoff 250ms → 1s → 4s
  • • Cron retry ogni 15 min per delivery falliti
  • • Timeout request: 8 secondi
  • • Auto-disable subscription dopo 10 failure consecutive
  • • Idempotency key in X-123Legionella-Delivery