Documentazione API e ambiente di test
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" |
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 | "2023" |
date | Data nel formato YYYYMMDD | "20230926" |
date-time | Data nel formato YYYYMMDD HH:mm:ss | "20230926 12:09:21" |
JWT | JSON Web Token algoritmo HS256 | "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" |
Il parametro apiKey
è necessari per effettuare
qualsiasi operazione
e deve essere inserito sia come parametro JSON del Token che come parametro di tutte le richieste.
Il parametro ateneoKey
è necessari per effettuare
qualsiasi operazione e deve essere inserito come parametro JSON nel Token di tutte le richieste.
L'endpoint di riferimento si trova all'indirizzo https://sisvaldidat.it/API/4
,
per cui le richieste sono nel formato https://sisvaldidat.it/API/4/operazione
.
L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici ad una funzione sono elencati nella sezione della funzione stessa.
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per verificare la correttezza dei parametri e visualizzare le informazioni sulla tua richiesta, utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/InfoRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita sarà un oggetto JSON contenente informazioni sulla correttezza dei tuoi parametri e sulle richieste rimanenti. Puoi elaborare la risposta come desiderato nella tua applicazione per verificare i dettagli e l'avanzamento delle tue richieste.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey": "", "ateneoKey": "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
401 | Forbidden. User does not exist. | |
403 | Forbidden. Request is missing valid credentials. | |
000 | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{ "VERSION":"v4", "SYSTEM":"SISValDidat - Sistema Informativo Statistico per la Valutazione della Didattica" } }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per visualizzare i metodi disponibili nelle richieste API, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/MethodRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita sarà un oggetto JSON contenente i metodi disponibili per le richieste API. Puoi elaborare la risposta come desiderato nella tua applicazione per visualizzare i metodi disponibili.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey": "", "ateneoKey": "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{"METHOD":{"InfoRequest":{"class":"API_Handler","function_name":"InfoRequest"},"MethodRequest":"class":"API_Handler","function_name":"MethodRequest"}} }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per ottenere la lista dei dati presenti nella Tavola di rieplogo per un determinato Corso di Studi, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetCDLTavolaRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.html
(opzionale): Un valore booleano che specifica se si desidera ottenere una tabella in formato HTML come output. Se non specificato, il formato di output sarà JSON.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desiderano i dati.facoltaKey
: Una stringa che rappresenta l'identificatore della Facoltà desiderata.cdlKey
: Una stringa che rappresenta l'identificatore del Corso di Studi desiderato.sedeKey
: Una stringa che rappresenta l'identificatore della Sede desiderata.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa al Corso di Studi.semestreKey
(opzionale): Un numero intero che rappresenta l'identificatore del semestre desiderato per filtrare i dati. Se non specificato, saranno restituiti i dati complessivi dell'intero anno.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita dipenderà dal formato di output specificato. Se html
è impostato su true
, verrà restituita una tabella in formato HTML. Altrimenti, verrà restituito un oggetto JSON contenente i dati richiesti. Puoi elaborare la risposta come desiderato nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "html" : "", "annoKey" : "", "facoltaKey" : "", "cdlKey" : "", "sedeKey" : "", "indagineKey" : "", "semestreKey" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, html (boolean) opzionale, annoKey (year) obbligatorio, facoltaKey (string) obbligatorio, cdlKey (string) obbligatorio, sedeKey (string) obbligatorio, indagineKey (integer) obbligatorio, semestreKey (integer) opzionale } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{"TITOLO":["Testo Domanda","Sezione","Esadecimale Sezione","Risposte","Non Risposte","P1","P2","Media","SQM","L1","L2"],"D1":["Il carico di lavoro complessivo degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",349,0,4.297994269340974,95.70200573065902,"8.6532951289398281","1.5341408829881",8.49233859868189,8.814251659197765],"D2":["L'organizzazione complessiva (orario, esami, intermedi e finali) degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",222,127,1.3513513513513513,98.64864864864865,"8.8918918918918919","1.32740928468737",8.717275731175503,9.06650805260828],"D3":["L'orario delle lezioni e' congegnato in modo tale da consentire un'adeguata attivita' di studio individuale?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",180,169,3.3333333333333335,96.66666666666667,"8.7722222222222222","1.40163733287582",8.567457340289582,8.976987104154862],"D4":["Le conoscenze preliminari possedute sono risultate sufficienti per la comprensione degli argomenti trattati?","ORGANIZZAZIONE INSEGNAMENTO","#680032",349,0,6.59025787965616,93.40974212034384,"8.4928366762177650","1.88858647781038",8.294692992067752,8.690980360367778]} }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per ottenere la lista dei dati presenti nella Tavola di rieplogo per una determinata Scuola/Dipartimento, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetFacoltaTavolaRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.html
(opzionale): Un valore booleano che specifica se si desidera ottenere una tabella in formato HTML come output. Se non specificato, il formato di output sarà JSON.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desiderano i dati.sedeKey
: Una stringa che rappresenta l'identificatore della Scuola/Dipartimento desiderata.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa alla Scuola/Dipartimento.semestreKey
(opzionale): Un numero intero che rappresenta l'identificatore del semestre desiderato per filtrare i dati. Se non specificato, saranno restituiti i dati complessivi dell'intero anno.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita dipenderà dal formato di output specificato. Se html
è impostato su true
, verrà restituita una tabella in formato HTML. Altrimenti, verrà restituito un oggetto JSON contenente i dati richiesti. Puoi elaborare la risposta come desiderato nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "html" : "", "annoKey" : "", "facoltaKey" : "", "indagineKey" : "", "semestreKey" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, html (boolean) opzionale annoKey (year) obbligatorio, sedeKey (string) obbligatorio, indagineKey (integer) obbligatorio, semestreKey (integer) opzionale } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{"TITOLO":["Testo Domanda","Sezione","Esadecimale Sezione","Risposte","Non Risposte","P1","P2","Media","SQM","L1","L2"],"D1":["Il carico di lavoro complessivo degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",349,0,4.297994269340974,95.70200573065902,"8.6532951289398281","1.5341408829881",8.49233859868189,8.814251659197765],"D2":["L'organizzazione complessiva (orario, esami, intermedi e finali) degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",222,127,1.3513513513513513,98.64864864864865,"8.8918918918918919","1.32740928468737",8.717275731175503,9.06650805260828],"D3":["L'orario delle lezioni e' congegnato in modo tale da consentire un'adeguata attivita' di studio individuale?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",180,169,3.3333333333333335,96.66666666666667,"8.7722222222222222","1.40163733287582",8.567457340289582,8.976987104154862],"D4":["Le conoscenze preliminari possedute sono risultate sufficienti per la comprensione degli argomenti trattati?","ORGANIZZAZIONE INSEGNAMENTO","#680032",349,0,6.59025787965616,93.40974212034384,"8.4928366762177650","1.88858647781038",8.294692992067752,8.690980360367778]} }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per ottenere la lista dei dati presenti nella Tavola di rieplogo dell'Ateneo, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetAteneoTavolaRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.html
(opzionale): Un valore booleano che specifica se si desidera ottenere una tabella in formato HTML come output. Se non specificato, il formato di output sarà JSON.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desiderano i dati.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa all'Ateneo.semestreKey
(opzionale): Un numero intero che rappresenta l'identificatore del semestre desiderato per filtrare i dati. Se non specificato, saranno restituiti i dati complessivi dell'intero anno.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita dipenderà dal formato di output specificato. Se html
è impostato su true
, verrà restituita una tabella in formato HTML. Altrimenti, verrà restituito un oggetto JSON contenente i dati richiesti. Puoi elaborare la risposta come desiderato nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "html": "", "annoKey" : "", "indagineKey" : "", "semestreKey" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, html (boolean) opzionale annoKey (year) obbligatorio, indagineKey (integer) obbligatorio, semestreKey (integer) opzionale } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{"TITOLO":["Testo Domanda","Sezione","Esadecimale Sezione","Risposte","Non Risposte","P1","P2","Media","SQM","L1","L2"],"D1":["Il carico di lavoro complessivo degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",349,0,4.297994269340974,95.70200573065902,"8.6532951289398281","1.5341408829881",8.49233859868189,8.814251659197765],"D2":["L'organizzazione complessiva (orario, esami, intermedi e finali) degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",222,127,1.3513513513513513,98.64864864864865,"8.8918918918918919","1.32740928468737",8.717275731175503,9.06650805260828],"D3":["L'orario delle lezioni e' congegnato in modo tale da consentire un'adeguata attivita' di studio individuale?","ORGANIZZAZIONE CORSO DI STUDI","#ff761a",180,169,3.3333333333333335,96.66666666666667,"8.7722222222222222","1.40163733287582",8.567457340289582,8.976987104154862],"D4":["Le conoscenze preliminari possedute sono risultate sufficienti per la comprensione degli argomenti trattati?","ORGANIZZAZIONE INSEGNAMENTO","#680032",349,0,6.59025787965616,93.40974212034384,"8.4928366762177650","1.88858647781038",8.294692992067752,8.690980360367778]} }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per ottenere la lista dei dati presenti nella Tavola di bersaglio dell'Ateneo, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetAteneoMedieRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.html
(opzionale): Un valore booleano che specifica se si desidera ottenere una tabella in formato HTML come output. Se non specificato, il formato di output sarà JSON.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desiderano i dati.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa all'Ateneo.semestreKey
(opzionale): Un numero intero che rappresenta l'identificatore del semestre desiderato per filtrare i dati. Se non specificato, saranno restituiti i dati complessivi dell'intero anno.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita dipenderà dal formato di output specificato. Se html
è impostato su true
, verrà restituita una tabella in formato HTML. Altrimenti, verrà restituito un oggetto JSON contenente i dati richiesti. Puoi elaborare la risposta come desiderato nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "html": "", "annoKey" : "", "indagineKey" : "", "semestreKey" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, html (boolean) opzionale annoKey (year) obbligatorio, indagineKey (integer) obbligatorio, semestreKey (integer) opzionale } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{"success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{ "TITOLO":[ "Esadecimale Sezione", "Testo Domanda", "Sezione", "Risposte", "Media"], "D1":[ "#ff761a", "Il carico di lavoro complessivo degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?", "ORGANIZZAZIONE CdS", 215201, 7.616 ]} }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per ottenere la lista dei dati presenti nella Tavola di bersaglio della Scuola, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetFacoltaMedieRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.html
(opzionale): Un valore booleano che specifica se si desidera ottenere una tabella in formato HTML come output. Se non specificato, il formato di output sarà JSON.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desiderano i dati.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa alla Scuola.semestreKey
(opzionale): Un numero intero che rappresenta l'identificatore del semestre desiderato per filtrare i dati. Se non specificato, saranno restituiti i dati complessivi dell'intero anno.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita dipenderà dal formato di output specificato. Se html
è impostato su true
, verrà restituita una tabella in formato HTML. Altrimenti, verrà restituito un oggetto JSON contenente i dati richiesti. Puoi elaborare la risposta come desiderato nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "html": "", "annoKey" : "", "indagineKey" : "", "semestreKey" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, html (boolean) opzionale annoKey (year) obbligatorio, indagineKey (integer) obbligatorio, semestreKey (integer) opzionale } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{"success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{ "TITOLO":[ "Esadecimale Sezione", "Testo Domanda", "Sezione", "Risposte", "Media"], "D1":[ "#ff761a", "Il carico di lavoro complessivo degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?", "ORGANIZZAZIONE CdS", 215201, 7.616 ]} }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per ottenere la lista dei dati presenti nella Tavola di bersaglio a livello di corso di studio, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetCDLMedieRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.html
(opzionale): Un valore booleano che specifica se si desidera ottenere una tabella in formato HTML come output. Se non specificato, il formato di output sarà JSON.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desiderano i dati.facoltaKey
: Una stringa che rappresenta l'identificatore univoco della facoltà di riferimento.cdlKey
: Una stringa che rappresenta l'identificatore univoco del corso di laurea.sedeKey
: Una stringa che rappresenta l'identificatore univoco della sede.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa al corso di studio.semestreKey
(opzionale): Un numero intero che rappresenta l'identificatore del semestre desiderato per filtrare i dati. Se non specificato, saranno restituiti i dati complessivi dell'intero anno.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita dipenderà dal formato di output specificato. Se html
è impostato su true
, verrà restituita una tabella in formato HTML. Altrimenti, verrà restituito un oggetto JSON contenente i dati richiesti. Puoi elaborare la risposta come desiderato nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "html" : "", "annoKey" : "", "facoltaKey" : "", "cdlKey" : "", "sedeKey" : "", "indagineKey" : "", "semestreKey" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, html (boolean) opzionale, annoKey (year) obbligatorio, facoltaKey (string) obbligatorio, cdlKey (string) obbligatorio, sedeKey (string) obbligatorio, indagineKey (integer) obbligatorio, semestreKey (integer) opzionale } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{"success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{ "TITOLO":[ "Esadecimale Sezione", "Testo Domanda", "Sezione", "Risposte", "Media"], "D1":[ "#ff761a", "Il carico di lavoro complessivo degli insegnamenti ufficialmente previsti nel periodo di riferimento (bimestre, trimestre, semestre, ecc.) \u00e8 accettabile?", "ORGANIZZAZIONE CdS", 215201, 7.616 ]} }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nel payload della richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per verificare se uno studente ha compilato il questionario dell'insegnamento inviato, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetStudenteRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desidera effettuare la verifica.facoltaKey
: Una stringa che rappresenta l'identificatore univoco della facoltà di riferimento.cdlKey
: Una stringa che rappresenta l'identificatore univoco del corso di laurea.utenteKey
: Una stringa che rappresenta l'identificatore univoco dello studente per il quale si desidera effettuare la verifica.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa all'insegnamento.insegnamentoKey
: Un numero intero che rappresenta l'identificatore dell'insegnamento per il quale si desidera effettuare la verifica.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita sarà un valore booleano (true o false) che indica se lo studente ha compilato il questionario dell'insegnamento inviato o meno. Puoi elaborare la risposta come desiderato nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. L'esempio di richiesta generica contiene una lista dei codici di errore comuni a tutte le richieste, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "annoKey" : "", "facoltaKey" : "", "cdlKey" : "", "utenteKey" : "", "indagineKey" : "", "insegnamentoKey" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, annoKey (year) obbligatorio, facoltaKey (string) obbligatorio, cdlKey (string) obbligatorio, utenteKey (string) obbligatorio, indagineKey (integer) obbligatorio, insegnamentoKey (integer) obbligatori } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token": { "codice insegnamento": true }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }
Passo 1: Ottenere un token JWT Prima di effettuare qualsiasi operazione tramite le API di Sisvaldidat, è necessario ottenere un token JWT valido. Il token JWT deve contenere il parametro apiKey
, che rappresenta la chiave di accesso fornita nella sezione "Amministrazione -> Api Key", e il parametro ateneoKey
, che rappresenta l'identificatore dell'ateneo per cui si desidera effettuare l'operazione. Assicurarsi che il token JWT sia incluso come parametro JSON nella richiesta e come parametro di tutte le richieste successive.
Passo 2: Formulare la richiesta Per ottenere la lista degli insegnamenti compilati per gli studenti inviati, si utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/GetStudenteInsegnamentiRequest
. La richiesta deve includere i seguenti parametri obbligatori nel payload JSON:
apiKey
: Una stringa che rappresenta la chiave di accesso.ateneoKey
: Un numero intero che identifica l'ateneo desiderato.annoKey
: Un campo di tipo "year" che specifica l'anno accademico per cui si desidera ottenere gli insegnamenti compilati.facoltaKey
: Una stringa che rappresenta l'identificatore univoco della facoltà di riferimento.cdlKey
: Una stringa che rappresenta l'identificatore univoco del corso di laurea.utenteKey
: Una stringa che rappresenta l'identificatore univoco dello studente per il quale si desidera ottenere gli insegnamenti compilati.indagineKey
: Un numero intero che rappresenta l'identificatore dell'indagine relativa agli insegnamenti.
Passo 3: Eseguire la richiesta Invia la richiesta al server utilizzando il metodo HTTP POST e l'endpoint specificato. Assicurati di includere il token JWT come parametro JSON nel payload della richiesta.
Passo 4: Elaborare la risposta La risposta restituita conterrà la lista degli insegnamenti compilati per gli studenti inviati. Puoi elaborare la risposta come desiderato, ad esempio, estrarre le informazioni rilevanti o visualizzare i dati nella tua applicazione.
Ricorda di gestire eventuali errori durante il processo di utilizzo delle API di Sisvaldidat. I codici di errore comuni sono elencati nell'esempio di richiesta generica, mentre eventuali altri errori specifici relativi a una funzione particolare saranno descritti nella documentazione specifica della funzione stessa.
Parametri | Formato Token | Struttura Token |
---|---|---|
apiKey (string) abbligatorio token (JWT) abbligatorio |
{ "apiKey" : "", "ateneoKey" : "", "annoKey" : "", "facoltaKey" : "", "cdlKey" : "", "utenteKey" : "", "indagineKey" : "", } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, annoKey (year) obbligatorio, facoltaKey (string) obbligatorio, cdlKey (string) obbligatorio, utenteKey (string) obbligatorio, indagineKey (integer) obbligatorio } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
400 | Bad Request. One or more required parameters were missing or invalid | |
405 | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. | |
401 | Forbidden. User does not exist. | |
000 | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token": { "CODICE UTENTE": [ { "indagineKey": , "indagineDesc":"---", "facoltaKey":"---", "cdlKey":"----", "insegnamentoKey":"----", "codice insegnamento":true, "statoDesc":"complete", "statoKey":1, }, { "indagineKey":, "indagineDesc":"---", "facoltaKey":"---", "cdlKey":"---", "insegnamentoKey":"---", "codice insegnamento":false, "statoDesc":"incomplete", "statoKey":0, }, } }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }