Risposta entro 24h lavorative — Richiedi preventivo
123

Developer docs

API pubbliche Open Data per la sicurezza sul lavoro

Risposta rapida

Lettura ~1 min
Quattro endpoint REST gratuiti, in JSON, con CORS aperto e licenza CC-BY-4.0: normativa medico competente, database malattie professionali, sentenze di Cassazione e atlante regionale INAIL. Pensati per essere citati da repository open-source, articoli su dev.to e StackOverflow, dashboard interne.

Copertura nazionale

Operiamo in tutte le regioni italiane

Medici iscritti elenco

Medici competenti abilitati e iscritti all’elenco nazionale

Conformità D.Lgs. 81/08

Servizi in linea con il Testo Unico Sicurezza

Gestione scadenze inclusa

Calendario visite, allegato 3B, riunioni

Trasparenza su costi

Preventivi chiari, senza voci nascoste

Endpoint disponibili

Normativa medico competente

Elenco strutturato degli articoli normativi (D.Lgs. 81/08, GDPR, D.Lgs. 66/2003, D.Lgs. 151/2001) con slug, titolo, fonte, articolo, topic.

GET /api/public/normativa

Query supportate: ?q=stringa&source=D.Lgs.+81%2F08&limit=50&offset=0

curl https://www.123medicocompetente.com/api/public/normativa?q=sorveglianza
Esempio risposta JSON
{
  "data": [
    {
      "slug": "articolo-41-sorveglianza-sanitaria",
      "url": "/normativa/articolo-41-sorveglianza-sanitaria/",
      "title": "Art. 41 — Sorveglianza sanitaria",
      "source": "D.Lgs. 81/08",
      "articolo": "41",
      "topics": ["sorveglianza sanitaria","idoneità","visite"]
    }
  ],
  "meta": { "count": 1, "total": 1, "license": "CC-BY-4.0", "cite": "https://www.123medicocompetente.com/api-docs/#cite" }
}

Malattie professionali (INAIL)

Database divulgativo delle malattie professionali tabellate e non tabellate, agente, apparato, gruppo INAIL, settori di esposizione.

GET /api/public/malattie-professionali

Query supportate: ?q=&sector=edilizia&inailGroup=2&listType=tabellata&limit=50&offset=0

curl "https://www.123medicocompetente.com/api/public/malattie-professionali?sector=edilizia"
Esempio risposta JSON
{
  "data": {
    "items": [ { "slug":"ipoacusia-da-rumore", "name":"Ipoacusia da rumore", "inailGroup":2, "listType":"tabellata" } ],
    "taxonomies": { "inailGroups": { "1":"Agenti chimici" } }
  },
  "meta": { "count": 1, "license": "CC-BY-4.0" }
}

Sentenze Cassazione (sicurezza lavoro)

Rielaborazioni didattiche di sentenze della Corte di Cassazione su medico competente, RSPP, sorveglianza sanitaria, delega di funzioni.

GET /api/public/sentenze

Query supportate: ?q=&year=2024&tema=sorveglianza&limit=50&offset=0

curl "https://www.123medicocompetente.com/api/public/sentenze?year=2024"
Esempio risposta JSON
{
  "data": {
    "items": [ { "numero":"n. 33333/2024", "anno":2024, "principio":"...", "temi":["medico competente"] } ],
    "disclaimer": "Contenuti divulgativi. Per il testo integrale consultare ItalGiure/CED Cassazione."
  },
  "meta": { "count": 1, "license": "CC-BY-4.0" }
}

Atlante INAIL — infortuni e MP per regione

Aggregati regionali su infortuni denunciati, casi mortali, malattie professionali riconosciute, settori a maggior incidenza.

GET /api/public/atlante

Query supportate: ?q=lombardia&region=lombardia&limit=50&offset=0

curl "https://www.123medicocompetente.com/api/public/atlante?region=lombardia"
Esempio risposta JSON
{
  "data": {
    "items": [ { "regionSlug":"lombardia","regionName":"Lombardia","totalInfortuni":121400,"mortali":152 } ],
    "dataset": { "name":"Atlante dei rischi sul lavoro in Italia — 2024", "license":"CC-BY-4.0" }
  },
  "meta": { "count": 1, "license": "CC-BY-4.0" }
}

Esempi codice

JavaScript

// JavaScript (fetch)
const res = await fetch('https://www.123medicocompetente.com/api/public/sentenze?year=2024&limit=10');
const { data, meta } = await res.json();
console.log(meta.total, data.items[0].principio);

Python

# Python (requests)
import requests
r = requests.get('https://www.123medicocompetente.com/api/public/malattie-professionali',
                 params={'sector': 'edilizia', 'limit': 100})
payload = r.json()
print(payload['meta']['total'], len(payload['data']['items']))

curl

# curl
curl -H 'Accept: application/json' \
  'https://www.123medicocompetente.com/api/public/atlante?region=lombardia'

Limiti di utilizzo

  • 1.000 richieste/ora per IP, gratuite, senza chiave.
  • 10.000 richieste/ora con header X-API-Key dedicato (programma in corso — richiedi accesso).
  • Risposte cacheabili: Cache-Control: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800.
  • ETag e If-None-Match supportati: ottieni 304 Not Modified se i dati non sono cambiati.
  • CORS aperto: utilizzabile direttamente da browser e Single Page App.

Licenza e come citare

Tutti i dataset esposti sono rilasciati con licenza Creative Commons BY 4.0. Puoi riusarli liberamente, anche per scopi commerciali, citando la fonte.

Citazione consigliata:

123 Medico Competente, "Open Data API sicurezza sul lavoro", 2026, https://www.123medicocompetente.com/api-docs/, licenza CC-BY-4.0.

Apri in Postman

Domande frequenti

Le API sono davvero gratuite?
Sì. Tutti gli endpoint pubblici sotto /api/public sono gratuiti, in JSON, con licenza CC-BY-4.0 e CORS aperto.
Posso usarle in un progetto commerciale?
Sì, la licenza CC-BY-4.0 consente anche l'uso commerciale, a condizione di citare la fonte (123 Medico Competente).
Quanto sono aggiornati i dati?
I dataset vengono aggiornati periodicamente dalla redazione (Redazione 123 Medico Competente). Il campo meta.generated_at indica il momento di generazione della risposta.
Esiste una collezione Postman?
Sì. Il pulsante "Apri in Postman" punta all'indice degli endpoint pubblici, importabile direttamente nello strumento.

Hai altre domande? Contatta 123 Medico Competente.

Fonti

Le fonti citate riguardano normativa primaria, documenti istituzionali e linee guida.

  1. D.Lgs. 9 aprile 2008, n. 81 — Gazzetta Ufficiale
  2. INAIL Open Data — dati.inail.it
  3. Creative Commons BY 4.0 — creativecommons.org

Hai bisogno di una chiave dedicata o di un dataset custom?

Compila il modulo: ti contattiamo per valutare nomina, visite mediche e sorveglianza sanitaria adatte alla tua azienda.

  • Risposta entro 24h lavorative
  • Senza impegno
  • Trattamento dati conforme GDPR
Richiedi preventivo

oppure scrivi a info@123medicocompetente.it

Non inviare dati sanitari personali