Il modello attuale prevede una richiesta di tipo POST, con i parametri codificati in formato JSON nel corpo della richiesta stessa. I formati dei parametri sono elencati nella tabella sottostante e variano a seconda della tipologia.
Formato dei parametri
| Tipo | Descrizione | Esempio |
|---|---|---|
| string | Stringa | "stringa" |
| text | Stringa di lunghezza massima 3000 caratteri | "stringa" |
| json | Json | {"it":"Stringa","en":"string"} se presente solo il testo in italiano può essere passato solo il valore "Stringa" |
| integer | Numero intero | "123" o 123 |
| double | Numero decimale | "123.45" o 123.45 |
| boolean | Variabile booleana | "true", true, "false" o false |
| year | Data nel formato YYYY | "2026" |
| date | Data nel formato YYYYMMDD | "20260701" |
| date-time | Data nel formato YYYYMMDD HH:mm:ss | "20260701 13:41:36" |
| JWT | JSON Web Token algoritmo HS256 | "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6Ikpva...." |
Il parametro apiKey è essenziale per qualsiasi operazione e deve essere incluso sia come parametro JSON nel Token che come parametro in tutte le richieste.
Il parametro ateneoKey è anch'esso fondamentale per qualsiasi operazione e deve essere inserito come parametro JSON nel Token di tutte le richieste.
L'endpoint di riferimento è situato all'indirizzo http://85.235.129.47/API/1,
quindi le richieste hanno il seguente formato: http://85.235.129.47/API/1/operazione.
L'esempio di richiesta generica include una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici di una funzione sono elencati nella sezione dedicata alla funzione stessa.
È importante sottolineare che il nostro servizio API limita a 10.000 le richieste ogni 5 ore per ciascun metodo individuale. Superare questo limite potrebbe causare un'interruzione nel flusso delle richieste. Si consiglia pertanto di monitorare attentamente il numero di richieste effettuate e di gestire l'utilizzo delle API in modo coerente con questo limite.