API Catalog
Un API catalog enumera tus API y apunta a la descripción, la documentación y el endpoint de estado de cada una, con el formato linkset de la RFC 9727.
Por qué importa
Es la forma en que un agente que nunca vio tu producto descubre que tienes una API, sin leer tu sitio de marketing.
Criterio de aprobación
/.well-known/api-catalog devuelve application/linkset+json con al menos una entrada.
Se registra cada solicitud que hace la verificación (URL, método, estado de la respuesta, encabezados relevantes y una vista previa del cuerpo) y se muestra bajo la verificación en tus resultados.
Cómo implementarlo
Publish an API catalog for automated API discovery (RFC 9727)
/.well-known/api-catalog devuelve application/linkset+json con al menos una entrada.
La guía de implementación paso a paso forma parte del plan Pro.
Ver planesEscanea tu sitio
Comprueba si esta verificación pasa en tu dominio, junto con las otras 21.
Verificaciones relacionadas
Descubrimiento de OAuth
/.well-known/oauth-authorization-server o /.well-known/openid-configuration exponen metadatos utilizables.
OAuth Protected Resource
/.well-known/oauth-protected-resource declara resource y authorization_servers.
Auth.md
/auth.md existe con un H1 en markdown que menciona auth.md.
MCP Server Card
/.well-known/mcp/server-card.json describe el servidor con un serverInfo.name.
A2A Agent Card
/.well-known/agent-card.json declara name, version y las interfaces compatibles.
Agent Skills
/.well-known/agent-skills/index.json enumera al menos una skill.
WebMCP
El código de la página registra herramientas del lado del navegador mediante navigator.modelContext.
Manifiesto ARD
/.well-known/ai-catalog.json declara specVersion, host y al menos una entrada.