# ALLEGATO 2: Pubblicazione e fruizione delle API, v2

**URL:** <https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888>\
**Category:** Aggiornamento LLGG PDND interoperabilità\
**Created:** [2 Agosto 2024, 11:19am UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888 "2024-08-02T11:19:34Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![agid-consultazioni](https://forum.italia.it/user_avatar/forum.italia.it/agid-consultazioni/32/13350_2.png) [@agid-consultazioni](https://forum.italia.it/u/agid-consultazioni)\
**Post date:** [2 Agosto 2024, 11:19am UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888/1 "2024-08-02T11:19:34Z")

</div>

Il presente allegato individua le funzionalità rese disponibili dall’ **Infrastruttura interoperabilità PDND** agli **Aderenti** e, nel contempo, riporta i ruoli degli **Utenti degli Aderenti** gestiti dalla stessa infrastruttura.  
[…]

Continua a leggere l’Allegato 2 sul [sito AgID](https://www.agid.gov.it/sites/agid/files/2024-08/All.2_LG_Infrastruttura_Interoperabilita_PDND_consultazione.pdf)

---

<div class="post-metadata">

**Author:** ![Sara\_Gasperetti](https://forum.italia.it/user_avatar/forum.italia.it/sara_gasperetti/32/13405_2.png) [@Sara\_Gasperetti](https://forum.italia.it/u/Sara_Gasperetti)\
**Post date:** [29 Agosto 2024, 3:10pm UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888/2 "2024-08-29T15:10:42Z")

</div>

**Capitolo 3.1.1 Ciclo di vita**  
Il punto “ARCHIVIA MANUALMENTE, da **SOSPESO** : l’Erogatore archivia manualmente la versione attualmente **sospesa** dell’e-service;” non è coerente con quanto riportato sia nel diagramma di flusso che nel capitolo 3.1 il quale riporta che “L’Erogatore PUÒ archiviare manualmente una versione **deprecata** di un e-service.” La frase dovrebbe quindi essere “ARCHIVIA MANUALMENTE, da **DEPRECATO** : l’Erogatore archivia manualmente la versione attualmente **deprecata** dell’e-service;”

---

<div class="post-metadata">

**Author:** ![Sara\_Gasperetti](https://forum.italia.it/user_avatar/forum.italia.it/sara_gasperetti/32/13405_2.png) [@Sara\_Gasperetti](https://forum.italia.it/u/Sara_Gasperetti)\
**Post date:** [3 Settembre 2024, 12:16pm UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888/3 "2024-09-03T12:16:47Z")

</div>

**Capitolo 3.1.2 Data model**  
In tabella viene riportato il campo `data revoca` come data della revoca dell’e-service (come riportato nella colonna “Descrizione”). Nella colonna “Modificabile” viene riportato che questo attributo viene valorizzato all’esecuzione della transazione di stato REVOCA. Lo stato REVOCATO non è più presente in queste linee guida e sembra essere stato sostituito dallo stato DEPRECATO. Si suggerisce quindi di modificare il campo `data revoca` con **`data depreca`** e di modificare la dicitura nella colonna “Modificabile” con “NO l’attributo è valorizzato una sola volta all’esecuzione della transazione di stato **DEPRECA** dall’Infrastruttura Interoperabilità PDND”.

---

<div class="post-metadata">

**Author:** ![Sara\_Gasperetti](https://forum.italia.it/user_avatar/forum.italia.it/sara_gasperetti/32/13405_2.png) [@Sara\_Gasperetti](https://forum.italia.it/u/Sara_Gasperetti)\
**Post date:** [3 Settembre 2024, 1:22pm UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888/4 "2024-09-03T13:22:38Z")

</div>

**Capitolo 4 Fruizione degli e-service**  
Paragrafo:

> L’Infrastruttura Interoperabilità PDND mette a disposizione dell’Erogatore, in via facoltativa, un meccanismo di approvazione automatica delle richieste di fruizione per un e-service. L’approvazione automatica è vincolata al soddisfacimento dei requisiti di fruizione con riferimento agli attributi certificati e dichiarati di cui l’Aderente che invia la richiesta di fruizione è in possesso.

Non è chiaro se, qualora vi siano attributi verificati, sia possibile impostare il meccanismo di approvazione automatica delle richieste di fruizione per un e-service. In caso contrario si suggerisce di esplicitare l’impossibilità di impostare il meccanismo di approvazione automatica qualora l’e-service richieda la presenza di attributi verificati. Rispetto alle linee guida precedenti in cui si precisava quanto segue:

> un Erogatore PUÒ ritenere valida - assumendosene la responsabilità - la verifica di un attributo effettuata da altro Erogatore, in considerazione della natura di quest’ultimo, nonché delle caratteristiche anche temporali dell’attributo;

è stata rimossa la possibilità di avvalersi della verifica effettuata precedentemente dall’Aderente stesso o da altri Erogatori? Se ciò fosse ancora valido, si potrebbe prevedere un meccanismo automatico. Nel caso contrario, ovvero che vadano verificati manualmente ogni volta gli attributi, il meccanismo di approvazione automatica non dovrà essere disponibile.

---

<div class="post-metadata">

**Author:** ![emmedi](https://forum.italia.it/user_avatar/forum.italia.it/emmedi/32/132_2.png) [@emmedi](https://forum.italia.it/u/emmedi)\
**Post date:** [5 Settembre 2024, 7:51am UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888/5 "2024-09-05T07:51:31Z")

</div>

Paragrafo 3.1.2. Data model  
Tabella con riportati i dati minimi dell’entità Interfaccia.  
**idl** _specifica dell’interfaccia legata alla versione dell’e-service_ dovrebbe essere obbligatorio SI e modificabile NO

---

<div class="post-metadata">

**Author:** ![emmedi](https://forum.italia.it/user_avatar/forum.italia.it/emmedi/32/132_2.png) [@emmedi](https://forum.italia.it/u/emmedi)\
**Post date:** [5 Settembre 2024, 10:31am UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888/6 "2024-09-05T10:31:56Z")

</div>

Paragrafo 3.1.2. Data model  
In considerazione del fatto che le specifiche dell’interfaccia (OpenAPI o WSDL) potrebbero non essere autoesplicative, si propone di rendere obbligatoria la pubblicazione di documentazione accessoria e manualistica per l’utilizzo dell’interfaccia.  
La documentazione dovrebbe essere obbligatoria soprattutto se le risposte del servizio hanno struttura articolata

---

<div class="post-metadata">

**Author:** ![Sara\_Gasperetti](https://forum.italia.it/user_avatar/forum.italia.it/sara_gasperetti/32/13405_2.png) [@Sara\_Gasperetti](https://forum.italia.it/u/Sara_Gasperetti)\
**Post date:** [13 Settembre 2024, 12:27pm UTC](https://forum.italia.it/t/allegato-2-pubblicazione-e-fruizione-delle-api-v2/39888/7 "2024-09-13T12:27:28Z")

</div>

**Capitolo 4. Fruizione degli e-service**

> L’Infrastruttura Interoperabilità PDND, completate le azioni da parte del Fruitore, DEVE comunicare le informazioni registrate da questi all’Erogatore dell’e-service nell’ipotesi in cui la stima di carico relativa alla specifica finalità richiesta del Fruitore ecceda la disponibilità precedentemente dichiarata dall’Erogatore.

- Si consiglia di specificare che la finalità viene approvata automaticamente qualora la stima di carico sia inferiore alla soglia prevista per ogni fruitore.
- Nel caso in cui la somma delle stime indicate da tutti i fruitori superi la soglia totale, la finalità non verrà approvata automaticamente e dovrà essere approvata manualmente dall’erogatore?
