api-padigitale2026-misura1.3.1-uni-afam

GitHub Contributors Issues Issues

API di PA digitale 2026 - 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 PA digitale 2026.

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.

:rocket: Link rapido alle linee guida d’implementazione degli e-service

:rocket: Link rapido alla release note

Tabella 1 – Descrizione delle nove API assegnate alle cinque fasce di Università e AFAM
Codice Nome Descrizione Operazione
IFS01 Consultazione offerta formativa (IFS01) Consente di consultare i corsi di studio offerti per ogni anno accademico e i relativi dettagli IFS01.1 - Acquisizione della lista dei corsi di studio offerti da un Istituto di formazione superiore in un dato anno accademico
IFS01.2 - Acquisizione del dettaglio di un corso di studio offerto da un Istituto di formazione superiore
IFS02 Consultazione iscrizioni accademiche (IFS02) Consente di consultare le iscrizioni per corso di studi negli ultimi 3 anni accademici, le prove d'iscrizione/ammissione, la trascrizione (esami, voti, ecc) degli studi, le attività svolte al di fuori dell'Istituto in cui uno studente si è diplomato 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 (insegnamenti conseguiti, 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
IFS03 Consultazione titoli accademici (IFS03) Consente di consultare il dettaglio dei titoli accademici conseguiti, le prove riguardanti il completamento e il livello di qualifica degli studi di istruzione terziaria e quelle relative allo strumento "Diploma Supplement" 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"
IFS04 Rettifica iscrizioni accademiche (IFS04) Consente di richiedere la rettifica di un'iscrizione accademica e consultarne lo stato. Inoltre, permette di comunicare la presenza di anomalie sui dati delle iscrizioni accademiche 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
IFS05 Rettifica titoli accademici (IFS05) Consente di richiedere la rettifica di un titolo accademico e consultarne lo stato. Inoltre, permette di comunicare la presenza di anomalie sui dati dei titoli accademici 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
IFS06 Consultazione variazioni iscrizioni accademiche (IFS06) Consente di consultare le variazioni delle iscrizioni negli ultimi tre anni accademici 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
IFS07 Consultazione variazioni titoli accademici (IFS07) Consente di consultare le variazioni dei titoli accademici IFS07.1 - Acquisizione delle "impronte (codifica hash)" di tutti i titoli accademici al fine di identificarne le variazioni dal punto di vista del fruitore
IFS08 Consultazione numero iscritti per fasce ISEE (IFS08) Consente di consultare il numero di studenti divisi per fasce ISEE dato un anno accademico IFS08.1 - Acquisizione del numero di studentesse e studenti per fasce ISEE in un anno accademico
IFS09 Consultazione numero iscritti a un corso di studi (IFS09) Consente di consultare il numero di studenti iscritti a un corso di studi dato un anno accademico 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

  1. Tipi di corsi
  2. Corsi di studio
  3. Classi di laurea
  4. Istituti di formazione superiore

Approfondimento nella sezione risorse utili

2 - Pubblicazione degli e-service su PDND</br> Si ricorda che in fase di pubblicazione degli e-service sulla piattaforma PDND, il nome deve rispettare quello nella colonna denominata “Nome” della tabella 1, ossia il seguente pattern e comunque seguire la guida alla pubbligazione degli e-serivce

3 - Linee Guida interoperabilità e Pattern di sicurezza AgID</br> L’implementazione degli e-service devono rispettare il profilo [ID_AUTH_REST_01] Direct Trust con certificato X.509 REST definito sulle LG interoperabilità e Pattern di sicurezza. E’ possibile approfondire un esempio sulla issue declinata sulla configurazione dell’API Gateway GovWay

4 - 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.

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

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

  1. URIs, Addressability, and the use of HTTP GET and POST
  2. w3shools-ref Compare GET vs. POST chapter

7 - 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:

  1. IFS01 Offerta Formativa
  2. IFS02 Iscrizioni
  3. IFS03 Titoli
  4. IFS04 Rettifica iscrizioni
  5. IFS05 Rettifica titoli
  6. IFS06 Variazioni Iscrizioni
  7. IFS07 variazione titoli
  8. IFS08 Iscrizioni per fasce ISEE
  9. IFS09 Iscrizioni per corso

IFS01 Offerta formativa

Definizione OpenApi.yaml

:globe_with_meridians: IFS01.1 - educational-offering-list

:jigsaw: 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

:globe_with_meridians: IFS01.2 - educational-offering-detail

:jigsaw: 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

AFAM vs Università

:arrow_double_up: 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

:globe_with_meridians: IFS02.1 - academic-enrollments

:jigsaw: 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

Le regole di obbligatorietà di output

  1. 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” }

2. 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 }

3. 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
4. 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.

```Di seguito l'obbligatorietà con "*"

  enrollment
     institute_code * 
     institute_name * 
     programme_type_code * 
     degree_course_code * 
     degree_class_code 
     academic_year * 
     degree_course_year * 
     status *

:globe_with_meridians: IFS02.2 - proof-tertiary-education-enrollments

:jigsaw: 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

:jigsaw: caso d’uso tipico: Acquisizione prove Single Digital Gateway (SDG)

:globe_with_meridians: IFS02.3 - proof-tertiary-education-courses

Acquisizione delle prove riguardanti la trascrizione (insegnamenti conseguiti, voti ottenuti, ecc.) degli studi di istruzione terziaria di una studentessa/studente, sono quindi le attività che lo studente ha già sostenuto durante il percorso formativo. La trascrizione può riferirsi a studi completati o in corso negli ultimi 3 anni accademici. Si fa riferimento ad attività superate o convalidate dallo studente, attività presenti a piano di studio approvato ed attività non sovrannumerarie

   Esempio IFS02.3 Request

   Esempio IFS02.3 Response

Osservazioni

:globe_with_meridians: IFS02.4 - proof-tertiary-education-admission

:jigsaw: 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

:globe_with_meridians: IFS02.5 - proof-mobility-periods

:jigsaw: 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

:arrow_double_up: Back to top

IFS03 Titoli

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

Definizione OpenApi.yaml

:globe_with_meridians: IFS03.1 - academic-qualifications

:jigsaw: 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

ESEMPI: 

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

"personal_data": {
   "tax_code": "RSSMRA80A01F205D",
   "person_id": "AB123456C"
 }

2) 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
 }

3) nel caso in cui uno dei valori presenti al punto 2 non sia possibile valorizzarlo, è necessario NON restituire l’istanza dell’iscrizione 4) 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 5) 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.

:globe_with_meridians: IFS03.2 - proof-tertiary-education-qualifications

:jigsaw: 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

:globe_with_meridians: IFS03.3 - proof-tertiary-education-qualifications-level

:jigsaw: caso d’uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove riguardanti il livello di qualifica degli studi di istruzione terziaria. Si fa riferimento ad attività superate o convalidate dallo studente, attività presenti a piano di studio approvato ed attività non sovrannumerarie

   Esempio IFS03.3 Request

   Esempio IFS03.3 Response

Osservazioni

:globe_with_meridians: IFS03.4 - proof-tertiary-education-qualifications-diploma-supplement

:jigsaw: caso d’uso tipico: Acquisizione prove Single Digital Gateway (SDG)

Acquisizione delle prove relative allo strumento “Diploma Supplement”. Si fa riferimento ad attività superate o convalidate dallo studente, attività presenti a piano di studio approvato ed attività non sovrannumerarie

   Esempio IFS03.4 Request

   Esempio IFS03.4 Response

Osservazioni

Risorse utili

:pencil2: Note compilazione campi

birth_place:

Esempio: birth_place=”Italia,MI,Milano”

Esempio: birth_place=”Austria,EE,Vienna”

:arrow_double_up: Back to top

IFS04 Rettifica iscrizioni

:jigsaw: 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

Osservazioni

:globe_with_meridians: IFS04.1 - academic-enrollment-change-request

:jigsaw: 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

:globe_with_meridians: IFS04.2 - academic-enrollment-change-request-status

:jigsaw: 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

:globe_with_meridians: IFS04.3 - academic-enrollment-change-request-cancellation

:jigsaw: 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

:globe_with_meridians: IFS04.4 - enrollments-issues

:jigsaw: 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

:pencil2: Note compilazione campi

birth_place:

Esempio: birth_place=”Italia,MI,Milano”

Esempio: birth_place=”Austria,EE,Vienna”

:arrow_double_up: 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

Osservazioni

:globe_with_meridians: IFS05.1 - academic-qualification-change-request

:jigsaw: 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

:globe_with_meridians: IFS05.2 - academic-qualification-change-request-status

:jigsaw: 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

:globe_with_meridians: IFS05.3 - academic-qualification-change-request-cancellation

:jigsaw: 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

:globe_with_meridians: IFS05.4 - academic-qualifications-issues

:jigsaw: 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

:pencil2: Note compilazione campi

birth_place:

Esempio: birth_place=”Italia,MI,Milano”

Esempio: birth_place=”Austria,EE,Vienna”

:arrow_double_up: Back to top

IFS06 Variazioni Iscrizioni

:jigsaw: caso d’uso tipico: Interazione con anagrafe ANIS

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

   Definizione OpenApi.yaml

:globe_with_meridians: IFS06.1 - student-enrollments-changes

:jigsaw: 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

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

:arrow_double_up: Back to top

IFS07 Variazione titoli

Richiede la lista di tutti i titoli conseguiti

   Definizione OpenApi.yaml

:globe_with_meridians: IFS07.1 - student-qualifications-changes

:jigsaw: 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

Esempio:

Vedere scenario operativo presente nel paragrafo delle iscrizioni di IFS06

:arrow_double_up: 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

:globe_with_meridians: 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

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

:arrow_double_up: Back to top

IFS09 Iscrizioni per corso

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

   Definizione OpenApi.yaml

:globe_with_meridians: 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

:arrow_double_up: Back to top

Scenario di utilizzo JSON-LD:

:construction: Work in progress

Risorse

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

Lo schema del master data pubblicato dal MUR può essere scaricato a questo link e i dataset sono disponibili nel seguente Repo

API Gateway Open Source per PDND

API Gateway Open Source condiviso nel portale web Developers.it, che implementa già il protocollo di autenticazione con la piattaforma PDND: link al software su Developers Italia e sito ufficiale di GovWay.

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.

Per maggiori informazioni:

29/10/2024

Authors 🚶

This site is open source. Improve this page.