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" |
text | Stringa di lunghezza massima 3000 caratteri | "stringa" |
json | Json | {"it":"Stringa","en":"string"} se presente solo il testo in italaino può essere pasato 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 | "2024" |
date | Data nel formato YYYYMMDD | "20241112" |
date-time | Data nel formato YYYYMMDD HH:mm:ss | "20241112 04:48:52" |
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.
È importante notare che il nostro servizio API impone un limite massimo di 10.000 richieste ogni 5 ore per ogni singolo metodo. Superare questo limite potrebbe causare un'interruzione nel flusso delle richieste. Si consiglia di monitorare attentamente il numero di richieste effettuate e di gestire l'utilizzo delle API in modo coerente con questo limite.
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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
403 | JSON | Forbidden. Request is missing valid credentials. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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 |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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.
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" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, annoKey (year) obbligatorio, facoltaKey (string) obbligatorio, cdlKey (string) obbligatorio, utenteKey (string) obbligatorio } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | 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." }
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/GetPublicEngagementRequest
. 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
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" : "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, annoKey (year) obbligatorio } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
401 | JSON | Forbidden. User does not exist. |
000 | JSON | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token": { { "Codice":"UNIFI-000000", "Titolo":"TITOLO", "Anno":2023, "Indagine":"Public engagement", "Url":"https:\/\/sisvaldidat.it\/AT-UNIFI\/AA-2023\/T-11\/VETRINA", "SSD":"INF\/01", "Descrizione":"DESCRIZIONE", "persone_coinvolte":"Prof.ssa ROSSI", }, { "Codice":"UNIFI-0000001", "Titolo":"TITOLO", "Anno":2023, "Indagine":"Public engagement", "Url":"https:\/\/sisvaldidat.it\/AT-UNIFI\/AA-2023\/T-11\/VETRINA", "Descrizione":"DESCRIZIONE", "persone_coinvolte":"BIANCHI", }, } }
{ "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 la correttezza dei parametri e visualizzare le informazioni sulla tua richiesta, utilizza il metodo HTTP POST all'endpoint specifico: https://sisvaldidat.it/API/4/
RequestJob. 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.strutturaKey
: Chiave del tipo di importazione che si vuole effettuareazione
: valori accettati add, delete e status
- Parametro
azione
valoreadd
:CREATE
: Indica che il job è stato creato e attende l'acquisizione dei dati.EXISTS
: Segnala che il job è già attivo e in attesa di ulteriori dati.ERROR
: Indica che il job non è stato creato con successo.
- Parametro
azione
valoreinfo
:EXISTS
: Il job è attivo e in attesa di dati.ERROR
: Il job non è stato creato correttamente.
- Parametro
azione
valoredelete
::DELETE
: Indica che il job è stato eliminato con successo.- Condizione: Il job può essere eliminato solamente quando si trova nello stato di attesa dei dati. Non è possibile eliminare il job una volta che l'importazione è terminata.
Si prega di notare che:
- Il parametro
azione
restituisce diverse risposte a seconda dello stato del job al momento della richiesta. - Con il paramentro
azione
impostato con valoreinfo
consente di verificare lo stato corrente del job, fornendo informazioni se è attivo o se vi sono problemi di creazione. - Con il paramentro
azione
impostato con valoredelete
è disponibile solo quando il job si trova nello stato di "attesa dei dati". Una volta completata l'importazione, questa opzione non è più disponibile per l'eliminazione del job.
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": "", "strutturaKey": "", "azione": "" } |
JSONRequest { apiKey (string) obbligatorio, ateneoKey (integer) obbligatorio, strutturaKey (integer) obbligatorio, azione (string) obbligatorio } |
Codice | Risposta | Descrizione |
---|---|---|
200 | JSON | The request has succeeded |
201 | JSON | Limited success. One or more batch requests failed for the command executed. |
400 | JSON | Bad Request. One or more required parameters were missing or invalid |
405 | JSON | Method not allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. |
702 | JSON | Maximum number of requests within 5 hours has been exceeded. |
900 | JSON | Execution script in error. |
701 | JSON | Structure job code not present. |
000 | JSON | Unknown application response request. |
{ "success":true, "response":"200", "responseDescription":"The request has succeeded", "token":{ "state":"CREATE", "jobKey":"3484" } }
{ "success":false, "response":"403", "responseDescription":"Forbidden. Request is missing valid credentials." }