Tools and references

The guide provides naming criteria and best practices for descriptions, keywords, and lexical consistency, ensuring that services are searchable and understandable in the catalog, in line with Annex 7 of the new AgID Guidelines.

🔗 https://italia.github.io/pdnd-guida-nomenclatura-eservice/

A tool to verify that OpenAPI files are compliant with the required specifications (mandatory fields, formats, consistency).
It is recommended to use it before publishing each version.

🔗 https://italia.github.io/api-oas-checker/
🔗 https://github.com/italia/api-oas-checker-rules

Verifies the correctness of semantic metadata (vocabularies, references, consistency) used in interface files, supporting semantic interoperability.

🔗 https://schema.gov.it/validatore_metadati

A collection of technical rules and patterns for designing APIs consistent with the Interoperability Model: security, versioning, schema management, and release cycles.

🔗 https://developers.italia.it/it/news/interoperabilita.html
🔗 https://www.agid.gov.it/it/infrastrutture/sistema-pubblico-connettivita/il-nuovo-modello-interoperabilita
🔗 https://www.agid.gov.it/it/argomenti/interoperabilita
🔗 https://www.agid.gov.it/it/agenzia/stampa-e-comunicazione/notizie/2023/05/23/aggiornati-i-pattern-sicurezza-linee-guida-sullinteroperabilita-tecnica-pa

Next page →