Tabella dei contenuti
v. 1 (deprecated)
PDND exposes a set of APIs for performing checks in machine-to-machine mode. Version 1 offers read-only operations and an initial version of an event channel, through which participants can stay updated on state changes occurring on the platform for components of interest to them (e.g., e-services they produce, service requests they receive, etc.).
Goals
- Allow producers to complete any checks necessary for providing e-services to consumers.
- Enable participants to automate part of their workflow based on the available information.
Philosophy
The APIs are designed to be as generic and agnostic as possible. For this reason, each response returns the relevant IDs of other linked objects, which can be used to make further API calls to retrieve the desired information.
Where to find them?
The service URL and the OpenAPI specification for the interface are available in the Consumption > Your Interop API clients section, within any machine-to-machine client that is created.
Notifications endpoint
Among its API endpoints, PDND also offers one that allows the participant to obtain a list of events. These events represent state changes that have occurred within the infrastructure. They can be used to receive timely updates and set up automations.
The model requires the producer to request the events of interest via polling.
Each event is identified by an incrementing sequence number (event ID). The party can request all events starting from a specific eventId, specifying the pagination size, i.e., the number of events to return (limit).
The participant can then cache the obtained results and download further events starting from the last obtained eventId.
Hai bisogno di aiuto?
Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata
