API di PAdigitale2026 - Misura 1.3.1 - Avvisi per Università e AFAM pubblici

API di PAdigitale2026 - Misura 1.3.1 - Avvisi per Università e AFAM pubblici

Questo repository contiene le specifiche delle API relative alla misura 1.3.1 per l'avviso dedicato alle Università pubbliche e AFAM (Alta Formazione Artistica, Musicale e Coreutica) pubblici, nell'ambito di PAdigitale2026.

La tabella sottostante (Tabella 1) riporta il dettaglio del titolo e descrizione per tutte e nove le API (dalla IFS01 alla IFS09) che dovranno essere erogate dai Soggetti Attuatori in base alla fascia di appartenenza.

🚀 Link rapido alle linee guida d'implementazione degli e-service

🚀 Link rapido alla release note

Tabella 1 – Descrizione delle nove API assegnate alle cinque fasce di Università e AFAM

Use Case	API-ID	e-service-name	API-Method	e-service description
Offerta formativa	IFS01	ifs-<codice istituto>-offerta-formativa	IFS01.1	Acquisizione della lista dei corsi di studio offerti da un Istituto di formazione superiore in un dato anno accademico
Offerta formativa	IFS01	ifs-<codice istituto>-offerta-formativa	IFS01.2	Acquisizione del dettaglio di un corso di studio offerto da un Istituto di formazione superiore
Iscrizioni	IFS02	ifs-<codice istituto>-iscrizioni	IFS02.1	Acquisizione del dettaglio delle ultime iscrizioni per corso di studi negli ultimi tre anni accademici di una studentessa o di uno studente
			IFS02.2	Acquisizione delle prove riguardanti l'iscrizione agli studi di istruzione terziaria di una studentessa/studente
			IFS02.3	Acquisizione delle prove riguardanti la trascrizione (corsi seguiti, voti ottenuti, ecc.) degli studi di istruzione terziaria di una studentessa/studente. La trascrizione può riferirsi a studi completati o in corso
			IFS02.4	Acquisizione delle prove riguardanti l'ammissione agli studi di istruzione terziaria di una studentessa/studente
			IFS02.5	Acquisizione delle prove relative alle attività di apprendimento svolte al di fuori dell'istituzione di istruzione terziaria dalla quale una studentessa/studente ha ottenuto il proprio diploma
Titoli	IFS03	ifs-<codice istituto>-titoli	IFS03.1	Acquisizione del dettaglio dei titoli accademici conseguiti da una studentessa/uno studente
			IFS03.2	Acquisizione delle prove riguardanti il completamento degli studi di istruzione terziaria
			IFS03.3	Acquisizione delle prove riguardanti il livello di qualifica degli studi di istruzione terziaria
			IFS03.4	Acquisizione delle prove relative allo strumento "Diploma Supplement"
Rettifica iscrizioni	IFS04	ifs-<codice istituto>-rettifica-iscrizioni	IFS04.1	Richiesta di rettifica di un'iscrizione accademica di una studentessa/uno studente all'Istituto di formazione superiore
			IFS04.2	Acquisizione dello stato delle richieste di rettifica delle iscrizioni accademiche di una studentessa/uno studente all'Istituto di istruzione superiore
			IFS04.3	Richiesta di annullamento di una richiesta di rettifica di una iscrizione accademica di una studentessa/uno studente all'Istituto di istruzione superiore
			IFS04.4	Invio di una segnalazione dall'ente fruitore all'ente erogatore per comunicare eventuali anomalie sui dati delle iscrizioni accademiche
Rettifica titoli	IFS05	ifs-<codice istituto>-rettifica-titoli	IFS05.1	Richiesta di rettifica di un titolo accademico di una studentessa/uno studente all'Istituto di formazione superiore
			IFS05.2	Acquisizione dello stato delle richieste di rettifica dei titoli accademici di una studentessa/uno studente all'Istituto di istruzione superiore
			IFS05.3	Richiesta di annullamento di una richiesta di rettifica di un titolo accademico di una studentessa/uno studente all'Istituto di istruzione superiore
			IFS05.4	Invio di una segnalazione dall'ente fruitore all'ente erogatore per comunicare eventuali anomalie sui dati dei titoli accademici
Variazioni Iscrizioni	IFS06	ifs-<codice istituto>-variazioni-iscrizioni	IFS06.1	Acquisizione delle "impronte (codifica hash)" di tutte le iscrizioni delle studentesse/degli studenti negli ultimi tre anni accademici al fine di identificarne le variazioni dal punto di vista del fruitore
Variazioni titoli	IFS07	ifs-<codice istituto>-variazioni-titoli	IFS07.1	Acquisizione delle "impronte (codifica hash)" di tutti i titoli accademici al fine di identificarne le variazioni dal punto di vista del fruitore
Iscritti per fasce ISEE	IFS08	ifs-<codice istituto>-iscrizioni-per-fasce-isee	IFS08.1	Acquisizione del numero di studentesse e studenti per fasce ISEE in un anno accademico
Iscritti a un corso per anno	IFS09	ifs-<codice istituto>-iscrizioni-per-corso	IFS09.1	Acquisizione del numero di studentesse e studenti iscritti a un corso di studi per anno accademico

Come indicato nella tabella sottostante (Tabella 2), gli Atenei e AFAM pubblici che possono aderire all’avviso sono divisi in fasce basate sul numero di iscritti, a cui corrisponde un numero preciso di API da erogare, dettagliate nella tabella 1.

Fascia	Iscritti	API (API ID)
1	<=1.000	7 (IFS01 – IFS07)
2	1.000 < iscritti <= 10.000	8 (IFS01 – IFS08)
3	10.000 < iscritti <= 20.000	8 (IFS01 – IFS08)
4	20.000 < iscritti <= 40.000	9 (IFS01 – IFS09)
5	> 40.000	9 (IFS01 – IFS09)

Tabella 2 – Fasce di Università in base al numero di studentesse e studenti iscritti ed API da erogare per ogni fascia.

Da sapere prima di iniziare a leggere le linee guida agli e-service

1 - Il Ministero dell'Università e della Ricerca (MUR) pubblica i seguenti vettori di dati codificati come open data a supporto dell'interoperabilità e dell'anagrafe ANIS

Tipi di corsi

Corsi di studio

Classi di laurea

Istituti di formazione superiore

⚠️ I canali di pubblicazione di questi vettori di dati da parte del MUR sono ancora in fase di definizione

Lo schema dei dataset può essere approfondito nella sezione risorse utili

2 - Nomi di pubblicazione degli e-service su PDND
⚠️ Si ricorda che in fase di pubblicazione degli e-service sulla piattaforma PDND, il nome deve rispettare quello nella colonna denominata e-service della tabella 1, ossia il seguente pattern:

    ifs-<codice istituto>-<nome e-service>
    ifs-16-offerta-formativa 
    
    Dove (16) è il codice dell'istituto del Politecnico di Milano 
    nel dataset Istituti di formazione superiore menzionato al punto 1

3 - La visualizzazione della specifica Open API e dei relativi esempi può essere ottenuta utlizzando l'editor swagger e copiando il contenuto dei file di tipo yaml che verranno forniti via via nella seguente trattazione di dettaglio.

4 - Il person_id riportato nella specifica delle API far riferimento all’identificativo univoco ANPR (Anagrafe Nazionale della Popolazione Residente).

5 - Perché abbiamo scelto di usare principalmente il metodo POST: GET Method vs POST Method

URIs, Addressability, and the use of HTTP GET and POST

w3shools-ref Compare GET vs. POST chapter

6 - Suggeriamo infine di fare riferimento sempre alla sezione risorse utili che è aggiornata periodicamente.

Linee guida agli e-service

In questo paragrafo sono descritte le seguenti API:

IFS01 Offerta Formativa
IFS02 Iscrizioni
IFS03 Titoli
IFS04 Rettifica iscrizioni
IFS05 Rettifica titoli
IFS06 Variazioni Iscrizioni
IFS07 variazione titoli
IFS08 Iscrizioni per fasce ISEE
IFS09 Iscrizioni per corso

IFS01 Offerta formativa

Definizione OpenApi.yaml

🌐 IFS01.1 - educational-offering-list

🧩 caso d'uso tipico: Alimentazione portale Universitaly

Acquisizione della lista dei corsi di studio offerti da un istituto di formazione superiore in un dato anno accademico

Esempio IFS01.1 Request

Esempio IFS01.1 Response

Osservazioni

La richiesta prevede l'obbligatorietà della compilazione del campo academic_year.

Nella risposta indicare solo corsi per i quali si può attivare una nuova coorte nell’anno accademico indicato. Includere corsi di Laurea, Dottorato, Diploma di specializzazione e Master.

Nella risposta il degree_course_code si riferisce al codice identificativo indicato nel relativo dataset pubblicato dal MUR sul repository "Codifiche MUR" https://github.com/MIPA-CINECA/codifiche-mur.

Nella risposta per il course_area indicare la denominazione della Classe di Laurea

Per il course_location indicare il codice ISTAT del comune della sede del corso.

Nel caso di corsi associabili a molteplici classi di Laurea, ciascuna combinazione corso/classe è individuata da degree_course_code differenti.

L'attributo cursor è utile per la paginazione della risposta:
1. Alla prima invocazione non si valorizza l'attributo cursor
2. Se la response restituisce l'attributo cursor valorizzato, sarà necessario iterare le invocazioni per ottenere l'intero dataset
3. Per le invocazioni successive alla prima si valorizza il campo cursor con il valore ottenuto nell'ultima response

E' lasciata allo sviluppatore dell'API la gestione della paginazione e quindi della valorizzazione del cursor sulla response

🌐 IFS01.2 - educational-offering-detail

🧩 caso d'uso tipico: Alimentazione portale universitaly

Acquisizione del dettaglio di un corso di studio offerto da un Istituto di formazione superiore

Esempio IFS01.2 Request

Esempio IFS01.2 Response

Osservazioni

Nella richiesta l'attributo degree_course_code è obbligatorio e si riferisce al codice identificativo di ANS, che individua in modo univoco la combinazione: Corso, Classe, anno accademico della coorte, sede

Nella risposta è sufficente includere il solo primo anno di corso dell’offerta formativa disponibile per la coorte identificata dal codice corso inviato come parametro di ingresso nella richiesta

AFAM vs Università

Nelle AFAM il degree_course_code è lo stesso per tutti gli anni accademici della coorte

Nella response per le università compilare i campi learning_ssd e learning_cfu

Nella response per gli AFAM compilare i campi learning_sad e learning_cfa

Vedere gli esempi presenti nello yaml/swagger e nella cartella doc/03_analysis/io_schema

⏫ Back to top

IFS02 Iscrizioni

Acquisisce il dettaglio delle iscrizioni accademiche. Fornisce le informazioni di dettaglio riguardanti le iscrizioni di una studentessa o uno studente all'università o AFAM

Definizione OpenApi.yaml

🌐 IFS02.1 - academic-enrollments

🧩 caso d'uso tipico: Alimentazione anagrafe ANIS

Acquisizione del dettaglio delle ultime iscrizioni per corso di studi negli ultimi tre anni accademici di una studentessa o di uno studente

Esempio IFS02.1 Request

Esempio IFS02.1 Response

Osservazioni

Regole di obbligatorietà input

Nella request popolare almeno il person_id o il tax_code dando priorità al person_id oppure il parametro key nel caso dello scenario descritto nell'API IFS06 per l'acquisizione delle variazioni

Le regole di obbligatorietà di output

Nella struttura "Personal Data" è necessario prevedere la restituizione delle informazioni relative al codice fiscale e/o codice fiscale + personID
ESEMPIO 1: 

"personal_data": {
   "tax_code": "RSSMRA80A01F205D"
 }

ESEMPIO 2: 

"personal_data": {
   "tax_code": "RSSMRA80A01F205D",
   "person_id": "AB123456C"
 }
Nella struttura "Personal Data" se il codice fiscale e/o il personID non sono presenti, restituire le informazioni given_name/family_name/birth_date/birth_place. Questa tipologia di response ha senso solo con l'invocazone dell'API che utilizza il parametro key, relativamente allo scenario descritto in IFS06

ESEMPIO 3:
"personal_data": {
   "given_name": Mario,
   "family_name": Rossi,
   "birth_date": 10-01-2022,
   "birth_place": Roma, RM, Italia
 }
Nel caso in cui uno dei valori presenti al punto 2 non sia possibile valorizzarlo, è necessario NON restituire l'istanza dell'iscrizione e rimandare all'errore 404 (vedi esempio nel file YAML)
ESEMPIO 4: 

status code=404

{
"personal_data": null,
 "enrollments": []
}
Nella struttura "enrollments" tutti i campi sono obbligatori tranne il degree_class_code. Nel caso in cui il degree_class_code non sia valorizzabile, è possibile passarlo con il valore NULL

Nella struttura "enrollments", qualora sia presente un attributo non valorizzabile (ad esclusione del attirubuto degree_class_code) l'istanza dell'iscrizione non deve essere restituita. In questa casistica, qualora sia presente solamente una iscrizione, prevedere la restituzione dello status code 404
  enrollment
     institute_code * 
     institute_name * 
     programme_type_code * 
     degree_course_code * 
     degree_class_code 
     academic_year * 
     degree_course_year * 
     status *

🌐 IFS02.2 - proof-tertiary-education-enrollments

🧩 caso d'uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove riguardanti l'ultima iscrizione a ogni corso di studi di istruzione terziaria di una studentessa/studente negli ultimi 3 anni accademici

Esempio IFS02.2 Request

Esempio IFS02.2 Response

Osservazioni

expected_graduation_date Indicare convenzionalmente 31/12/(anno immat + durata normale del corso) es. immatricolato Laurea Triennale 01/10/20 => expected_graduation_date = 31/12/2023

enrollment_date Indicare convenzionalmente la data di inizio (es 01/10/xxxx) dell’anno accademico cui si riferisce l’ultima iscrizione attiva per il corso individuato dal degree_course_code

🧩 caso d'uso tipico: Acquisizione prove Single Digital Gateway (SDG)

🌐 IFS02.3 - proof-tertiary-education-courses

Acquisizione delle prove riguardanti la trascrizione (corsi seguiti, voti ottenuti, ecc.) degli studi di istruzione terziaria di una studentessa/studente. La trascrizione può riferirsi a studi completati o in corso negli ultimi 3 anni accademici

Esempio IFS02.3 Request

Esempio IFS02.3 Response

Osservazioni

Vanno considerate solo gli elementi del Piano degli Studi approvato con insegnamenti in posizione di effettivo (solo esclusi quelli in soprannumero) con esame sostenuto o convalidato

attended_learning_name Il nome dell’insegnamento va indicato nella lingua di erogazione dell’insegnamento stesso.

start_date/end_date Indicare date convenzionali in base all’anno accademico ed al semestre

grade_value Espressione regolare del tipo <Voto numerico> o <Voto numerico> + 'L' o 'QUALIFIED' o null
30L o 30 o QUALIFIED o null

🌐 IFS02.4 - proof-tertiary-education-admission

🧩 caso d'uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove riguardanti le ultime ammissioni ai corsi di studi di istruzione terziaria di una studentessa/studente negli ultimi 3 anni accademici

Esempio IFS02.4 Request

Esempio IFS02.4 Response

Osservazioni

start_date_of_academic_year/end_date_of_academic_year Indicare date convenzionali di inizio/ fine anno accademico

🌐 IFS02.5 - proof-mobility-periods

🧩 caso d'uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove relative alle attività di apprendimento svolte al di fuori dell'istituzione di istruzione terziaria dalla quale una studentessa/studente ha ottenuto il proprio titolo accademico

Esempio IFS02.5 Request

Esempio IFS02.5 Response

Osservazioni

e-service ancora non completamente consolidato, è in corso l’analisi con il partner EU per il suo raffinamento. Nella versione corrente sembra riferito solo al Learning Agreement, che descrive le condizioni di avvio del programma di scambio e non comprende il consuntivo degli esami sostenuti, definito dal Trascript of Records. Da chiarire se sono di interesse anche gli scambi nazionali, per i quali non è previsto un Learning Agreement.

mobility_period_type Valore enumerato come di segutio
trimestrale, semestrale, annuale, breve_termine, lungo_termine

destination_erasmus_code L'informazione non è sempre disponibile => parametro opzionale

destination_institute_name La destinazione di uno scambio potrebbe non essere un Ateneo => parametro opzionale

destination_department L'informazione non è sempre disponibile => parametro opzionale

departure_department L'informazione non è sempre disponibile => parametro opzionale

birth_place Dove possibile il campo deve contenere le informazioni concatenate della Nazione/Provincia/Comune. Il formato previsto prevede la seguente espressione regolare
.*,[a-zA-Z]*,[a-zA-Z]
<nome_nazione>,<codice_provincia>,<nome_comune> Esempio: birth_place="Italia,MI,Milano"
Nel caso di comuni esteri, se non fosse possibile recuperare il codice_provincia, si potrà inserire la codifica EE
Esempio: birth_place="Austria,EE,Vienna"

⏫ Back to top

IFS03 Titoli

Restituisce l'elenco dei titoli conseguiti da una studentessa o uno studente

Definizione OpenApi.yaml

🌐 IFS03.1 - academic-qualifications

🧩 caso d'uso tipico: Alimentazione anagrafe ANIS

Acquisizione del dettaglio dei titoli accademici conseguiti da una studentessa/uno studente

Esempio IFS03.1 Request

Esempio IFS03.1 Response

Osservazioni

Passare tutti i dati disponibili e la profondità storica dipende dagli istituti di formazione superiore.

Includere tutti coloro che hanno conseguito un titolo di Laurea, Dottorato, Diploma di specializzazione o Master

In caso di Laurea congiunta esiste un unico titolo, sulla cui pergamena sono riportati entrambi gli Atenei e che è gestito dal solo Ateneo di riferimento (l’unico che comunica i dati della carriera ad ANSU).

qualification_grade_value: Espressione regolare del tipo <Voto numerico> o <Voto numerico> + 'L' o 'QUALIFIED' o null
30L o 30 o QUALIFIED o null

Regole di obbligatorietà output (si prega di verificare gli esempi sul file openapi):

Nella struttura "Personal Data" è necessario prevedere la restituizione delle informazioni relative al codice fiscale e/o codice fiscale + personID
ESEMPI: 

"personal_data": {
   "tax_code": "RSSMRA80A01F205D"
 }

"personal_data": {
   "tax_code": "RSSMRA80A01F205D",
   "person_id": "AB123456C"
 }
Nella struttura "Personal Data" se il codice fiscale e/o il personID non sono presenti, restituire le informazioni given_name/family_name/birth_date/birth_place
ESEMPIO: 

"personal_data": {
   "given_name": Mario,
   "family_name": Rossi,
   "birth_date": 10-01-2022,
   "birth_place": Roma, RM, Italia
 }
nel caso in cui uno dei valori presenti al punto 2 non sia possibile valorizzarlo, è necessario NON restituire l'istanza dell'iscrizione e rimandare all'errore 404 (vedi esempio nel file YAML)

nella struttura "qualifications" tutti i campi sono obbligatori tranne il degree_class_code. Nel caso in cui il degree_class_code non sia valorizzabile, è possibile passarlo con il valore NULL

nella struttura "qualifications", qualora sia presente un attributo non valorizzabile (ad esclusione degli attributi degree_class_code/qualification_grading_scale_maximum_grade/qualification_grading_scale_minimum_grade/) non dovrà essere restituito Item.
Qualora fosse presente solamente una qualifica e nel caso in cui quest'ultima non dovesse riportare i dati obbligatori, prevedere la restituzione dello status code 404

🌐 IFS03.2 - proof-tertiary-education-qualifications

🧩 caso d'uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove riguardanti il completamento degli studi di istruzione terziaria

Esempio IFS03.2 Request

Esempio IFS03.2 Response

Osservazioni

Passare tutti i dati disponibili, la profondità storica dipende dagli atenei. Includere tutti coloro che hanno conseguito un titolo di Laurea, Dottorato, Diploma di specializzazione o Master. In caso di Laurea congiunta esiste un unico titolo, sulla cui pergamena sono riportati entrambi gli Atenei, e che è gestito dal solo Ateneo di riferimento (l’unico che comunica i dati della carriera ad ANSU).

Regole di obbligatorietà output (si prega di verificare gli esempi sul file openapi):

Nella struttura "Personal Data" è necessario prevedere la restituizione delle informazioni relative al codice fiscale e/o codice fiscale + personID

Nella struttura "Personal Data" se il codice fiscale e/o il personID non sono presenti, restituire le informazioni given_name/family_name/birth_date/birth_place

nel caso in cui uno dei valori presenti al punto 2 non sia possibile valorizzarlo, è necessario NON restituire l'istanza dell'iscrizione e rimandare all'errore 404 (vedi esempio nel file YAML)

🌐 IFS03.3 - proof-tertiary-education-qualifications-level

🧩 caso d'uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove riguardanti il livello di qualifica degli studi di istruzione terziaria

Esempio IFS03.3 Request

Esempio IFS03.3 Response

Osservazioni

has_parent_relation Si riferisce al legame di genitorialità (biologica o adottiva) tra un genitore e la persona di riferimento (richiedente). Se non calcolabile => null

degree_course_duration_in_months Durata normale del corso espresso in mesi per gestire corsi di master di durata inferiore all’anno

Regole di obbligatorietà output (si prega di verificare gli esempi sul file openapi):

Nella struttura "Personal Data" è necessario prevedere la restituizione delle informazioni relative al codice fiscale e/o codice fiscale + personID

Nella struttura "Personal Data" se il codice fiscale e/o il personID non sono presenti, restituire le informazioni given_name/family_name/birth_date/birth_place

nel caso in cui uno dei valori presenti al punto 2 non sia possibile valorizzarlo, è necessario NON restituire l'istanza dell'iscrizione e rimandare all'errore 404 (vedi esempio nel file YAML)

🌐 IFS03.4 - proof-tertiary-education-qualifications-diploma-supplement

🧩 caso d'uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove relative allo strumento "Diploma Supplement"

Esempio IFS03.4 Request

Esempio IFS03.4 Response

Osservazioni

access_to_regulated_profession Fare riferimento al punto 5.2 del Diploma Supplement “accesso ad una professione regolamentata” che elenca le professioni per le quali è possibile ottenere l’abilitazione all’esercizio tramite il superamento di un Esame di Stato.

learning_start_date/ learning_end_date Indicare date convenzionali in base all’anno accademico ed al semestre

Regole di obbligatorietà output (si prega di verificare gli esempi sul file openapi):

Nella struttura "Personal Data" è necessario prevedere la restituizione delle informazioni relative al codice fiscale e/o codice fiscale + personID

Nella struttura "Personal Data" se il codice fiscale e/o il personID non sono presenti, restituire le informazioni given_name/family_name/birth_date/birth_place

nel caso in cui uno dei valori presenti al punto 2 non sia possibile valorizzarlo, è necessario NON restituire l'istanza dell'iscrizione e rimandare all'errore 404 (vedi esempio nel file YAML)

Risorse utili

✏️ Note compilazione campi

birth_place:

Dove possibile il campo deve contenere le informazioni concatenate del Nazione/Provincia/Comune.

il formato previsto prevede la seguente forma: *<nome_nazione>,<codice_provincia>,<nome_comune>, *

Esempio: birth_place="Italia,MI,Milano"

Nel caso di comuni esteri, se non fosse possibile recuperare il codice_provincia, si potrà inserire la codifica EE

Esempio: birth_place="Austria,EE,Vienna"

RegEx applicata: .,[a-zA-Z],[a-zA-Z]*

⏫ Back to top

IFS04 Rettifica iscrizioni

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Richiede la rettifica dei dati di un’iscrizione mancante o in eccesso per una studentessa o uno studente che stia frequentando o abbia frequentato.

Definizione OpenApi.yaml

🌐 IFS04.1 - academic-enrollment-change-request

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Richiesta di rettifica di un'iscrizione accademica di una studentessa/uno studente all'Istituto di formazione superiore

Esempio IFS04.1 Request

Esempio IFS04.1 Response

🌐 IFS04.2 - academic-enrollment-change-request-status

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Acquisizione dello stato delle richieste di rettifica delle iscrizioni accademiche di una studentessa/uno studente all'Istituto di istruzione superiore

Esempio IFS04.2 Request

Esempio IFS04.2 Response

🌐 IFS04.3 - academic-enrollment-change-request-cancellation

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Richiesta di annullamento di una richiesta di rettifica di una iscrizione accademica di una studentessa/uno studente all'Istituto di istruzione superiore

Esempio IFS04.3 Request

Esempio IFS04.3 Response

Osservazioni

Valorizzare in input almeno un campo tra tax_code e person_id

🌐 IFS04.4 - enrollments-issues

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Invio di una segnalazione dall'ente fruitore all'ente erogatore per comunicare eventuali anomalie sui dati delle iscrizioni accademiche

Esempio IFS04.4 Request

Esempio IFS04.4 Response

Osservazioni

Valorizzare in input almeno un campo tra tax_code e person_id

nel caso in cui in input gli attributi tax_code/person_id non siano valorizzabili, compilare i parametri given_name/family_name/birth_date/birth_place

✏️ Note compilazione campi

birth_place:

Dove possibile il campo deve contenere le informazioni concatenate del Nazione/Provincia/Comune.

il formato previsto prevede la seguente forma: *<nome_nazione>,<codice_provincia>,<nome_comune>, *

Esempio: birth_place="Italia,MI,Milano"

Nel caso di comuni esteri, se non fosse possibile recuperare il codice_provincia, si potrà inserire la codifica EE

Esempio: birth_place="Austria,EE,Vienna"

RegEx applicata: .,[a-zA-Z],[a-zA-Z]*

⏫ Back to top

IFS05 Rettifica titoli

Richiede la rettifica dei dati di un’iscrizione mancante o in eccesso per una studentessa o uno studente che stia frequentando o abbia frequentato.

Definizione OpenApi.yaml

🌐 IFS05.1 - academic-qualification-change-request

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Richiesta di rettifica di un titolo accademico di una studentessa/uno studente all'Istituto di formazione superiore

Esempio IFS05.1 Request

Esempio IFS05.1 Response

🌐 IFS05.2 - academic-qualification-change-request-status

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Acquisizione dello stato delle richieste di rettifica dei titoli accademici di una studentessa/uno studente all'Istituto di istruzione superiore

Esempio IFS05.2 Request

Esempio IFS05.2 Response

🌐 IFS05.3 - academic-qualification-change-request-cancellation

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Richiesta di annullamento di una richiesta di rettifica di un titolo accademico di una studentessa/uno studente all'Istituto di istruzione superiore

Esempio IFS05.3 Request

Esempio IFS05.3 Response

🌐 IFS05.4 - academic-qualifications-issues

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Invio di una segnalazione dall'ente fruitore all'ente erogatore per comunicare eventuali anomalie sui dati dei titoli accademici

Esempio IFS05.4 Request

Esempio IFS05.4 Response

✏️ Note compilazione campi

birth_place:

Dove possibile il campo deve contenere le informazioni concatenate del Nazione/Provincia/Comune.

il formato previsto prevede la seguente forma: *<nome_nazione>,<codice_provincia>,<nome_comune>, *

Esempio: birth_place="Italia,MI,Milano"

Nel caso di comuni esteri, se non fosse possibile recuperare il codice_provincia, si potrà inserire la codifica EE

Esempio: birth_place="Austria,EE,Vienna"

RegEx applicata: .,[a-zA-Z],[a-zA-Z]*

⏫ Back to top

IFS06 Variazioni Iscrizioni

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Richiede la lista delle ultime iscrizioni per ogni corso di studi negli ultimi 10 anni accademici.

Definizione OpenApi.yaml

🌐 IFS06.1 - student-enrollments-changes

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Acquisizione delle "impronte (codifica hash)" di tutte le iscrizioni delle studentesse/degli studenti negli ultimi tre anni accademici al fine di identificarne le variazioni dal punto di vista del fruitore

Esempio IFS06.1 Request

Esempio IFS06.1 Response

Osservazioni

Si ricorda di NON valorizzare il campo "cursor" nell'esecuzione della prima chiamata.

Qualora nella response fosse presente il campo "cursor" valorizzato, prevedere la sua valorizzazione nelle chiamate successive.

Prevedere, tramite l'attributo "cursor", una strategia di paginazione dei risultati restituiti dalla API. Qualora l'attributo fosse restituito NULLO (o non presente), nessuna chiamata successiva deve essere effettuata dal client.

Esempio:

Scenario operativo di acquisizione delle variazioni delle iscrizioni fra l'anagrafe ANIS e un Istituto di istruzione superiore

N.B. Si prega di visionare anche la sezione IFS02

⏫ Back to top

IFS07 Variazione titoli

Richiede la lista dei titoli conseguiti negli ultimi 10 anni accademici

Definizione OpenApi.yaml

🌐 IFS07.1 - student-qualifications-changes

🧩 caso d'uso tipico: Interazione con anagrafe ANIS

Acquisizione delle "impronte (codifica hash)" di tutti i titoli accademici al fine di identificarne le variazioni dal punto di vista del fruitore

Esempio IFS07.1 Request

Esempio IFS07.1 Response

Osservazioni

Si ricorda prevedere di NON valorizzare il campo "cursor" nell'esecuzione della prima chiamata.

Qualora nella response fosse presente il campo "cursor" valorizzato, prevedere la sua valorizzazione nelle chiamate successive.

Prevedere, tramite l'attributo "cursor", una strategia di paginazione dei risultati restituiti dalla API. Qualora l'attributo fosse restituito NULLO (o non presente), nessuna chiamata successiva deve essere effettuata dal client.

⏫ Back to top

IFS08 Iscrizioni per fasce ISEE

Acquisisce il numero di studentesse e studenti per fasce ISEE in un anno accademico

Definizione OpenApi.yaml

🌐 IFS08.1 - count_academic_enrollments_by_isee_ranges

Acquisizione del numero di studentesse e studenti per fasce ISEE in un anno accademico

Esempio IFS08.1 Request

Esempio IFS08.1 Response

Osservazioni

La API deve essere organizzata secondo la ripartizione degli scaglioni coerenti con i provvedimenti normativi in vigore relativamente alla tassazione universitaria (No-tax area e progressività) per gli Atenei statali e gli istituti AFAM statali (L. 232/2016, DM 1014/2021, DM 1016/2021). Si riportano di seguito la proposta di ripartizione degli scaglioni corente con la normativa vigente e con maggiore dettaglio per finalità amministrative di analisi

E' di libero arbitrio degli istituti la scelta di definire una soglia minima di studenti entro la quale mostrare la fascia di reddito.

scaglioni ISEE

<=13.000

13.001-16.000

Classe di ampiezza 2.000 da 16.001-40.000

Classe di ampiezza 5.000 da 40.001-60.000

Classe di ampiezza 10.000 da 60.001-100.000

>100.000

ISEE non presentato

⏫ Back to top

IFS09 Iscrizioni per corso

Ottiene il numero di studentesse e di studenti iscritti ad un IFS.

Definizione OpenApi.yaml

🌐 IFS09.1 - count_academic_enrollments_by_degree_courses

Acquisizione del numero di studentesse e studenti iscritti a un corso di studi per anno accademico

Esempio IFS09.1 Request

Esempio IFS09.1 Response

Osservazioni

Il dato può cambiare nel corso dell’anno a causa di:

immatricolazioni al secondo semestre

immatricolazioni di dottorandi scaglionate su diverse finestre di ingresso

ricongiunzioni

avvio di nuove edizioni di Corsi di Master in qualsiasi mese dell’anno

vedere gli input/output di esempio sopra riportati

nel caso in cui i parametri male_enrollment_count o female_enrollment_count non siano valorizzabili -> restituire un valore nullo

⏫ Back to top

Scenario di utilizzo JSON-LD:

🚧 Work in progress

Risorse

Visualizzatore OpenApi.yaml in formato Swagger: https://editor.swagger.io/
Convertitore di x-jsonle-context in json: https://yml2json.com/
Convertitore di Json in Json-ld https://json-ld.org/playground/

Risorse utili

Masterdata pubblicato dal Ministero dell'Università e della Ricerca

Per la valorizzazione dei campi institude_code, programme_type_code, degree_course_code, degree_class_code si prega di fare riferimento al Master data pubblicato dal Ministero dell'Università e della Ricerca (MUR) con i seguenti dataset

institute
programme-type
degree-class
degree-course

Lo schema del master data pubblicato dal MUR può essere scaricato a questo link

⚠️ Sono ancora in fase di definizione i canali di pubblicazione del Master data e il relativo schema. E' comunque consigliato realizzare una "cache" del Master data nei sistemi locali da aggiornare periodicamente.

Solo a titolo meramente esemplificativo, possono essere ottenute informazioni aggiuntive nei metadati pubblicati dall'Ufficio di Statistica del Ministero dell'Università e della Ricerca (MUR).

Per qualsiasi richeiesta di chiarimento potete aprire una issue su questo repository GitHub

Cursor pagination

L'impaginazione basata sul cursore consente di recuperare in modo efficiente set di dati di grandi dimensioni da un database suddividendoli in "pagine" più piccole.

Business canvas

Il business canvas è il documento utilizzato dal gruppo di lavoro per la collaborazione e per la modellazione delle specifiche Open API.

Name		Name	Last commit message	Last commit date
Latest commit History 588 Commits
doc		doc
src		src
README.md		README.md
release-note.md		release-note.md

italia/api-padigitale2026-misura1.3.1-uni-afam

Folders and files

Latest commit

History

Repository files navigation

API di PAdigitale2026 - Misura 1.3.1 - Avvisi per Università e AFAM pubblici

Da sapere prima di iniziare a leggere le linee guida agli e-service

Linee guida agli e-service

IFS01 Offerta formativa

🌐 IFS01.1 - educational-offering-list

🌐 IFS01.2 - educational-offering-detail

IFS02 Iscrizioni

🌐 IFS02.1 - academic-enrollments

🌐 IFS02.2 - proof-tertiary-education-enrollments

🌐 IFS02.3 - proof-tertiary-education-courses

🌐 IFS02.4 - proof-tertiary-education-admission

🌐 IFS02.5 - proof-mobility-periods

IFS03 Titoli

🌐 IFS03.1 - academic-qualifications

🌐 IFS03.2 - proof-tertiary-education-qualifications

🌐 IFS03.3 - proof-tertiary-education-qualifications-level

🌐 IFS03.4 - proof-tertiary-education-qualifications-diploma-supplement

IFS04 Rettifica iscrizioni

🌐 IFS04.1 - academic-enrollment-change-request

🌐 IFS04.2 - academic-enrollment-change-request-status

🌐 IFS04.3 - academic-enrollment-change-request-cancellation

🌐 IFS04.4 - enrollments-issues

IFS05 Rettifica titoli

🌐 IFS05.1 - academic-qualification-change-request

🌐 IFS05.2 - academic-qualification-change-request-status

🌐 IFS05.3 - academic-qualification-change-request-cancellation

🌐 IFS05.4 - academic-qualifications-issues

IFS06 Variazioni Iscrizioni

🌐 IFS06.1 - student-enrollments-changes

Esempio:

IFS07 Variazione titoli

🌐 IFS07.1 - student-qualifications-changes

IFS08 Iscrizioni per fasce ISEE

🌐 IFS08.1 - count_academic_enrollments_by_isee_ranges

IFS09 Iscrizioni per corso

🌐 IFS09.1 - count_academic_enrollments_by_degree_courses

Scenario di utilizzo JSON-LD:

Risorse

Risorse utili

Masterdata pubblicato dal Ministero dell'Università e della Ricerca

Cursor pagination

Business canvas

Per maggiori informazioni:

Ultima Modifica 🔬

Authors 🚶

About

Resources

Stars

Watchers

Forks