Documentazione API e ambiente di test

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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 effettuare
• azione: valori accettati add, delete e status

• Parametro azione valore add:
  • 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 valore info:
  • EXISTS: Il job è attivo e in attesa di dati.
  • ERROR: Il job non è stato creato correttamente.

• Parametro azione valore delete::
  • 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 valore info 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 valore delete è 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.