API Catalog
Un API Catalog elenca le tue API e punta alla descrizione, alla documentazione e all'endpoint di stato di ciascuna, usando il formato linkset di RFC 9727.
Perché è importante
È il modo in cui un agente che non ha mai visto il tuo prodotto scopre che hai un'API, senza leggere il tuo sito di marketing.
Criteri di superamento
/.well-known/api-catalog restituisce application/linkset+json con almeno una voce.
Ogni richiesta effettuata dal controllo viene registrata — URL, metodo, stato della risposta, header rilevanti e anteprima del corpo — e mostrata sotto il controllo nei tuoi risultati.
Come implementarlo
Publish an API catalog for automated API discovery (RFC 9727)
/.well-known/api-catalog restituisce application/linkset+json con almeno una voce.
Le istruzioni di implementazione passo passo fanno parte del piano Pro.
Vedi i pianiScansiona il tuo sito
Scopri se questo controllo passa sul tuo dominio, insieme agli altri 21.
Controlli correlati
Scoperta OAuth
/.well-known/oauth-authorization-server o /.well-known/openid-configuration espone metadati utilizzabili.
OAuth Protected Resource
/.well-known/oauth-protected-resource dichiara resource e authorization_servers.
Auth.md
/auth.md esiste con un H1 Markdown che menziona auth.md.
MCP Server Card
/.well-known/mcp/server-card.json descrive il server con un serverInfo.name.
A2A Agent Card
/.well-known/agent-card.json dichiara name, version e le interfacce supportate.
Agent Skills
/.well-known/agent-skills/index.json elenca almeno una skill.
WebMCP
Il codice della pagina registra strumenti lato browser tramite navigator.modelContext.
Manifest ARD
/.well-known/ai-catalog.json dichiara specVersion, host e almeno una voce.