DevPortalPagoPA



Tabella dei contenuti

📐 OpenAPI

Specifiche

Le specifiche sono disponibili all'indirizzo: https://developer.io.italia.it/openapi.html

File

Note

Sono presenti alcune estensioni custom che non saranno bene interpretate da tool aderenti allo standard openAPI 2.0 (fka swagger https://swagger.io/specification/v2/):
  • x-extensible-enum: dove utilizzata, sostituisce quello che nello standard è espresso con enum . È in corso la sua sostituzione con enum standard;
  • x-import: per alcune definizioni, specifica dove si trova la definizione del tipo nelle librerie di PagoPA (Typescript). Non ha un corrispettivo nello standard OpenAPI. Non è immediatamente evidente quali siano i requisiti di formato di un campo specifico e si deve recuperare manualmente la definizione puntata dalla reference;
  • x-one-of: usato in combinazione con allOf, sta ad indicare che allOf non rappresenta una intersezione dei tipi elencati, ma piuttosto si comporta come oneOf introdotto con la versione 3 dello standard OpenAPI. È utilizzato nel tipo ServicePayload;
  • x-example: aggiunge un esempio dove lo standard non permette di utilizzare il tag example.

Hai bisogno di aiuto?

Scrivi un’email in cui descrivi il tuo problema o dubbio all’indirizzo onboarding@io.italia.it

Dicci cosa ne pensi

Per segnalare problemi o dare feedback, lascia un commento nello spazio Github dell'app IO