API esposte da PDND Interoperabilità

Il set di API REST esposte da PDND Interoperabilità agli aderenti, comunemente chiamate API gateway

L'URL del servizio e la specifica OpenAPI dell'interfaccia sono reperibili all'interno della sezione Fruizione > I tuoi client api interop, all'interno di qualsiasi client machine to machine venga creato. Non viene pubblicato qui perché l'URL varia in funzione dell'ambiente in cui ci si trova.

Si prega di consultare la sezione dedicata all'ottenimento di un voucher da spendere sulle API di PDND Interoperabilità.

Nell'API che PDND Interoperabilità espone il modello dati è come segue:

PDND Interoperabilità offre un canale in pull attraverso il quale l'aderente può ottenere una lista di eventi. Questi eventi rappresentano i cambiamenti di stato occorsi all'interno dell'infrastruttura. In pratica, l'aderente può avere una notifica per quando un e-service viene sospeso, una richiesta di fruizione riattivata, ecc.

Nonostante l'endpoint per ottenere gli eventi sia parte delle API esposte da PDND Interoperabilità, gli dedichiamo uno spazio apposito dato il rilievo della funzionalità. Il modello di canale pull prevede che l'erogatore si occupi di richiedere gli eventi di suo interesse in polling. I parametri specifici della chiamata sono parte della documentazione di interfaccia, qui ci limitiamo a specificare il meccanismo di funzionamento.

Ogni evento è identificato da un numero d’ordine crescente (id dell'evento). L'aderente può richiedere tutti gli eventi a partire da un determinato eventId, specificando la dimensione della paginazione, cioè il numero di eventi da restituire (limit) . L'aderente può fare caching dei risultati ottenuti, e scaricare ulteriori eventi a partire dall'ultimo eventId ottenuto.