# API dei dati aperti

Tutto ciò che è pubblicato su Tempussit — corsi, articoli del blog, concetti e domande frequenti — è disponibile in JSON per programmi e assistenti IA. Sola lettura, senza chiave né registrazione.

## Cosa è disponibile

**`GET /data/v1/index.json`**

Indice: lingue del sito, cataloghi dei corsi e link a tutti i file di dati.

**`GET /data/v1/courses/{languageKey}.json`**

Corsi di una lingua del catalogo, 100 per pagina (parametro ?page=).

**`GET /data/v1/course/{slug}.json`**

Scheda di un corso pubblicato: titolo, descrizione, autore, lingue, prezzo, programma, indirizzo della pagina e copertina.

**`GET /data/v1/{languageCode}/{kind}.json`**

Concetti, domande frequenti, sezioni e articoli del blog in una lingua del sito.

**`GET /data/v1/openapi.json`**

Descrizione di tutte le risposte nel formato OpenAPI 3.1.

## Esempi di richieste

```
curl https://tempussit.com/data/v1/index.json
curl https://tempussit.com/data/v1/courses/it.json
curl https://tempussit.com/data/v1/course/{slug}.json
curl -I https://tempussit.com/data/v1/it/faq.json

fetch("https://tempussit.com/data/v1/it/glossary.json")
  .then(response => response.json());
```

## Condizioni

- Sola lettura: sono accettate solo richieste GET e HEAD.
- Il numero di richieste per indirizzo IP al minuto è limitato. Oltre il limite la risposta è 429 con l’intestazione Retry-After.
- Le risposte possono essere memorizzate nella cache per 5 minuti e richieste dal browser da qualsiasi sito (Access-Control-Allow-Origin: \*).
- Solo ciò che è visibile sulle pagine pubbliche: niente bozze, acquisti o dati personali.
- La versione fa parte dell’indirizzo (/data/v1/). I precedenti indirizzi senza versione continuano a funzionare.

aggiornato il 9 novembre 2026