Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Accedere a PDND Interoperabilità.
  2. Cliccare su "I tuoi e-service" nel menu laterale, sotto "Erogazione".
  3. Cliccare su "Crea nuovo".
  4. Compilare i campi. Per la PDND, generalmente si ha a che fare con servizi REST che erogano informazioni.
    Il nome e la descrizione dell'e-service sono disponibili nella Tabella 1 – Descrizione delle nove API assegnate alle cinque fasce di Università e AFAM del progetto GitHub api-padigitale2026-misura1.3.1-uni-afam (https://github.com/italia/api-padigitale2026-misura1.3.1-uni-afam/tree/2.1) - Versione del 8-novembre. Questi codici, nomi e descrizione devono essere copiati così come da GitHub o dalla tabella sottostante
    Assicurarsi che siano spuntate la tecnologia REST e tipo di e-service Eroga prima di proseguire.

    Codice e-serviceNome e-serviceDescrizione e-service
    IFS01Consultazione offerta formativa (IFS01)Consente di consultare i corsi di studio offerti per ogni anno accademico e i relativi dettagli
    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

    IFS03Consultazione 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"
    IFS04Rettifica 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
    IFS05Rettifica 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
    IFS06Consultazione variazioni iscrizioni accademiche (IFS06)Consente di consultare le variazioni delle iscrizioni negli ultimi tre anni accademici
    IFS07Consultazione variazioni titoli accademici (IFS07)Consente di consultare le variazioni dei titoli accademici
    IFS08Consultazione numero iscritti per fasce ISEE (IFS08)Consente di consultare il numero di studenti divisi per fasce ISEE dato un anno accademico
    IFS09Consultazione 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
  5. Procedere cliccando su "Salva bozza e prosegui".
  6. La Durata validità, Chiamate API per fruitore e Chiamate API totali variano in base alla dimensione dell'Ente, fare riferimento alla tabella sottostante per maggiori informazioni. Se si desidera fornire automaticamente la fruizione del servizio ai richiedenti (consigliato in ambiente di collaudo), attivare il toggle dedicato sull'interfaccia.
    Prestare attenzione a quanto si inserisce nel campo audience: se si sta configurando l'integrazione per l'ente unix, per il servizio IFS01 in ambiente collaudo, bisognerà inserire unix-pdnd-collaudo/ifs01, quindi la regola generale è  (nome_ente)-pdnd-(ambiente)/(codice ifs). Gli ambienti possono essere collaudo oppure prod.
    Un esempio di audience per il collaudo dell'università unicineca che vuole attivare l'eservice ifs01 diventa quindi unicineca-pdnd-collaudo/ifs01. Il nome_ente da utilizzare è quello legato a Esse3 o comunque concordato con Cineca.
    Una configurazione errata in questo punto causerà la mancata erogazione del servizio (errore "The requested audience does not match the authorized audience").

    Codice e-serviceDurata validità (minuti)Chiamate API Fruitore
    Ateneo con iscrizioni negli ultimi 3 anni < 80.000

    Chiamate API Fruitore
    Ateneo con iscrizioni negli ultimi 3 anni >= 80.000

    Chiamate API Totali
    Ateneo con iscrizioni negli ultimi 3 anni < 80.000

    Chiamate API Totali
    Ateneo con iscrizioni negli ultimi 3 anni >= 80.000

    IFS0110

    14.40014400 28.800

    28800 

    18.00018000 36.000

    36000 

    IFS0210

    86.40086400 216.000

    216000 

    108.000108000 270.000

    270000 

    IFS0310

    86.40086400 216.000

    216000 

    108.000108000 270.000

    270000 

    IFS0410

    14.40014400 28.800

    28800 

    18.00018000 36.000

    36000 

    IFS0510

    14.40014400 28.800

    28800 

    18.00018000 36.000

    36000 

    IFS0610

    1.4401440 1.440

    1440 

    1.8001800 1.800

    1800 

    IFS0710

    1.4401440 1.440

    1440 

    1.8001800 1.800

    1800 

    IFS0810

    1.4401440 1.440

    1440 

    1.8001800 1.800

    1800 

    IFS0910

    1.4401440 1.440

    1440 

    1.8001800 1.800

    1800 

  7. Procedere cliccando su "Salva bozza e prosegui".
  8. Impostare gli attributi minimi, indicati nella tabella che segue per ogni IFS. E' possibile definire altri attributi aggiuntivi. L'attributo "ENTE" deve venire sostituito con il nome del consorziato.


    Codice e-serviceAttributo certificato

    IFS01 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS02 

    PUBBLICHE AMMINISTRAZIONI, ENTE, Cineca Consorzio Interuniversitario

    IFS03 

    PUBBLICHE AMMINISTRAZIONI, ENTE, Cineca Consorzio Interuniversitario

    IFS04 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS05 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS06 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS07 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS08 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS09 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

  9. Procedere cliccando su "Salva bozza e prosegui".
  10. Accedere al servizio di preparazione della specifica API fornito da CINECA, disponible a questo indirizzo: https://pdnd-api-documentation.api.cineca.it/swagger-ui
  11. Cliccare su "try it out", inserire le informazioni richieste (la password è la doc_password contenuta nella configurazione dell'ente ed è stata comunicata in fase di collaudo) e poi su execute.
  12. Cliccare su "download";

...