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.
Domande frequenti
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.