Tabella dei contenuti
References and tools
Guide to naming e-services
The Department for Digital Transformation has created a dedicated guide for e-service nomenclature, consisting of a set of best practices for naming and describing them on PDND.
The goal is to make services more easily searchable and identifiable.
Members are required to follow the guidelines provided in the guide, available at the following link: https://italia.github.io/pdnd-guida-nomenclatura-eservice/.
API validator
The Department for Digital Transformation has published a tool that allows verification of the compatibility of one’s REST API interface with the requirements set out in AgID’s ModI.
Members are required to verify that their interface file passes the validator’s checks before publishing their e-service.
The API validator is available at the following link: https://italia.github.io/api-oas-checker/, and is accompanied by Usage guides.
Semantic validator
The Department for Digital Transformation, together with Istat, has published a tool to verify the metadata of semantic resources present in interface files.
The validator is part of a broader project:
Schema is the continuously evolving catalog that harmonizes and standardizes shared data models, ensuring that the format and meaning of the exchanged information are preserved and understood during exchanges.
The semantic validator is available at the following link: https://schema.gov.it/validatore_metadati.
Developing APIs compliant with ModI
For some articles on API development, refer to the dedicated news section on Developers Italia. Also, see the ModI page on the AgID website and the related list of updates.
For more information on security patterns, refer to the dedicated AgID guidelines.
To consult the “Operational Document – Security Patterns” and related examples contained in the attachment “Guidelines on the Technical Interoperability of Public Administrations,” you must download it to your computer and open it with the Adobe Acrobat application.
This way, you will have access to an index of all the attachments contained in the document, as shown in the image below.
Hai bisogno di aiuto?
Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata
