Tabella dei contenuti
04 Agosto 2025
Nuove funzionalità
API v. 2, secondo rilascio
Vengono aggiunti 29 nuovi endpoint di lettura e scrittura su vari domini, e integrati i parametri di query di 3 endpoint già rilasciati in precedenza. Di seguito il dettaglio degli endpoint. Per la documentazione completa, si guardi il documento di interfaccia aggiornato.
E-service (e-service)
| Endpoint | Descrizione |
|---|---|
| POST /reversePurposeeservicePurposes | Carica una nuova analisi del rischio per un tuo e-service di erogazione inversa in stato di bozza |
Richieste di fruizione (agreement)
| Endpoint | Descrizione |
|---|---|
| GET /agreements/{agreementId}/purposes | Restituisce le finalità associate ad una richiesta di fruizione |
| GET /agreements/{agreementId}/contract | Restituisce il documento PDF che attesta l'attivazione della richiesta di fruizione |
| GET /agreements/{agreementId}/consumerDocuments | Restituisce la documentazione che un fruitore ha associato ad una richiesta di fruizione. La documentazione caricata viene utilizzata dall'erogatore per conferire al fruitore uno o più attributi verificati |
| GET /agreements/{agreementId}/consumerDocuments/{documentId} | Restituisce uno specifico documento caricato per una richiesta di fruizione |
| POST /agreements/{agreementId}/clone | Clona una richiesta di fruizione |
| POST /agreements/{agreementId}/consumerDocuments | Carica uno o più documenti per una richiesta di fruizione. La documentazione caricata viene utilizzata dall'erogatore per conferire al fruitore uno o più attributi verificati |
| DELETE /agreements/{agreementId} | Elimina una propria richiesta di fruizione in bozza |
| DELETE /agreements/{agreementId}/consumerDocuments/{documentId} | Elimina uno specifico documento caricato per una richiesta di fruizione in stato di bozza |
Finalità (purpose)
| Endpoint | Descrizione |
|---|---|
| GET /purposes/{purposeId}/agreement | Restituisce la richiesta di fruizione associata ad una finalità |
| GET /purposes/{purposeId}/versions/{versionId}/riskAnalysisDocument | Restituisce il contenuto dell'analisi del rischio associata ad una versione di finalità. Viene creata una nuova versione di finalità ogni volta che si altera la stima di carico |
| DELETE /purposes/{purposeId} | Elimina una propria finalità in stato di bozza |
| DELETE /purposes/{purposeId}/versions/{versionId} | Elimina una propria versione di finalità in stato di bozza |
Attributi (attribute)
| Endpoint | Descrizione |
|---|---|
| GET /certifiedAttributes | Restituisce la lista degli attributi certificati |
| GET /declaredAttributes/{attributeId} | Restituisce uno specifico attributo dichiarato |
| GET /verifiedAttributes/{attributeId} | Restituisce uno specifico attributo verificato |
| POST /declaredAttributes | Crea un nuovo attributo dichiarato |
| POST /verifiedAttributes | Crea un nuovo attributo verificato |
Deleghe (delegation)
| Endpoint | Descrizione |
|---|---|
| GET /producerDelegations | Restituisce le deleghe in erogazione conferite dal proprio ente |
| POST /producerDelegations | Crea una nuova richiesta di delega per l'erogazione verso un altro ente (potenziale delegato) |
| POST /producerDelegations/{delegationId}/accept | Accetta una delega in erogazione inoltrata da un altro ente |
| POST /producerDelegations/{delegationId}/reject | Rifiuta una delega in erogazione inoltrata da un altro ente |
Client (client)
| Endpoint | Descrizione |
|---|---|
| GET /clients | Restituisce la lista dei client del proprio ente |
| GET /clients/{clientId} | Restituisce il dettaglio di un client del proprio ente |
| GET /clients/{clientId}/purposes | Restituisce la lista di finalità alle quali un client è associato |
| GET /clients/{clientId}/keys | Restituisce la lista delle chiavi di un client |
| DELETE /clients/{clientId}/purposes/{purposeId} | Disassocia un client da una finalità |
Ente (tenant)
| Endpoint | Descrizione |
|---|---|
| GET /tenants/{tenantId}/declaredAttributes | Restituisce la lista degli attributi dichiarati di un ente |
| GET /tenants/{tenantId}/verifiedAttributes | Restituisce la lista degli attributi verificati di un ente |
Endpoint integrati
Per 3 endpoint di GET già pubblicati nel primo rilascio si inseriscono gli ultimi parametri di query utili a richiedere risultati filtrati. I 3 endpoint sono:
| Endpoint | Descrizione |
|---|---|
| GET /eservices | Restituisce una lista di e-service |
| GET /agreements | Restituisce una lista di richieste di fruizione |
| GET /purposes | Restituisce una lista di finalità |
Hai bisogno di aiuto?
Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata
