---
title: OpenAPI
description: "OpenAPI è il modo standard del settore, leggibile dalla macchina, di descrivere un'API REST — i suoi endpoint, parametri, formati di richiesta e risposta e autenticazione — in un unico file di specifica. TracePass pubblica una specifica OpenAPI 3.1 così che qualsiasi strumento o agente IA possa scoprire e richiamare l'API del passaporto senza documentazione su misura."
canonical: "https://www.tracepass.eu/it/glossary/openapi"
locale: it
source: "https://www.tracepass.eu/it/glossary/openapi"
---

# OpenAPI

> OpenAPI è il modo standard del settore, leggibile dalla macchina, di descrivere un'API REST — i suoi endpoint, parametri, formati di richiesta e risposta e autenticazione — in un unico file di specifica. TracePass pubblica una specifica OpenAPI 3.1 così che qualsiasi strumento o agente IA possa scoprire e richiamare l'API del passaporto senza documentazione su misura.

OpenAPI è il modo standard del settore, leggibile dalla macchina, di descrivere un'API REST — i suoi endpoint, parametri, formati di richiesta e risposta e autenticazione — in un unico file di specifica. TracePass pubblica una specifica OpenAPI 3.1 così che qualsiasi strumento o agente IA possa scoprire e richiamare l'API del passaporto senza documentazione su misura.

Un documento OpenAPI è un unico contratto strutturato che descrive esattamente cosa offre un'API REST: ogni percorso, i metodi che accetta, i campi di ogni richiesta e risposta, i codici di stato e lo schema di autenticazione. Poiché il formato è standardizzato, strumenti come Postman, Insomnia e openapi-generator possono importarlo per produrre automaticamente SDK client, server mock e documentazione interattiva.

La specifica OpenAPI 3.1 di TracePass è il contratto pubblico e scaricabile dietro l'API e la documentazione — e sempre più ciò che gli agenti IA leggono per primo per capire come operare il flusso dei passaporti prima di richiamarlo. È la controparte REST del server MCP: le stesse capacità, esposte come un'API HTTP convenzionale.

## FAQ

### Cosa aggiunge OpenAPI 3.1 rispetto alle versioni precedenti?

OpenAPI 3.1 allinea pienamente la specifica a JSON Schema, così che i modelli di richiesta e risposta possano essere descritti con lo stesso vocabolario usato altrove negli strumenti moderni. Ciò rende il contratto più pulito da validare e più facile da consumare per generatori di codice e agenti IA.

### Posso importare la specifica OpenAPI di TracePass in Postman?

Sì. La specifica è pubblicata come file OpenAPI 3.1 scaricabile (YAML e JSON) e si importa direttamente in Postman, Insomnia, Bruno o openapi-generator per generare richieste, codice client e test contro l'API del passaporto.

## Related terms

- [MCP (Model Context Protocol)](https://www.tracepass.eu/it/glossary/mcp)
- [JSON-LD](https://www.tracepass.eu/it/glossary/json-ld)
- [Passaporto digitale di prodotto (DPP)](https://www.tracepass.eu/it/glossary/digital-product-passport)
- [Punteggio di affidabilità](https://www.tracepass.eu/it/glossary/confidence-score)