Documentación de la API pública

LobbyStack ofrece una pequeña superficie pública de descubrimiento para que los agentes encuentren documentación, estado, metadatos OpenAPI, skills y preferencias de uso legibles por máquina sin hacer scraping del sitio.

Estos endpoints públicos de descubrimiento no requieren autenticación. Los metadatos OAuth se publicarán en el host de la aplicación cuando las API protegidas expongan endpoints de autorización reales.

Para quién es esta superficie de descubrimiento

Estos endpoints ayudan a desarrolladores, motores de búsqueda, agentes de IA, lectores de feeds y herramientas de integración a identificar la documentación pública y los recursos de producto legibles por máquina de LobbyStack. Son interfaces de descubrimiento, no un plano de control autenticado para llamadas o cuentas de clientes.

Acceso y comportamiento de las respuestas

  • • Los endpoints públicos de descubrimiento aceptan solicitudes GET o HEAD sin autenticación.
  • • El endpoint de estado informa la salud pública del servicio; no expone datos de clientes ni datos operativos.
  • • Las API protegidas de la aplicación se documentan por separado y requieren el método de autenticación que publica el host de la aplicación.
  • • La página de inicio admite la negociación Accept: text/markdown; las demás representaciones Markdown publicadas están disponibles en los endpoints .md que se indican a continuación.

Endpoints de descubrimiento

EndpointTipo de contenidoPropósito
/.well-known/api-catalogapplication/linkset+jsonLinkset del catálogo de API.
/openapi.jsonapplication/vnd.oai.openapi+jsonDescripción OpenAPI del servicio.
/llms.txttext/plainContexto breve de producto, funciones, precios y descubrimiento para LLM.
/feed.xmlapplication/rss+xmlFeed RSS con el contenido completo del blog.
/schemamap.xmlapplication/xmlMapa de descubrimiento de los endpoints de datos estructurados.
/schema/page.jsonapplication/ld+jsonGrafo JSON-LD de las páginas públicas.
/schema/post.jsonapplication/ld+jsonGrafo JSON-LD de los artículos del blog.
/es/index.mdtext/markdownResumen de la página de inicio en markdown.
/es/features.mdtext/markdownResumen de las funciones en markdown.
/es/pricing.mdtext/markdownPrecios, uso incluido, reglas de uso y tarifas por excedente en markdown.
/.well-known/agent-skills/index.jsonapplication/jsonÍndice de descubrimiento de agent skills.
/.well-known/mcp/server-card.jsonapplication/jsonTarjeta del servidor MCP.

Ejemplos de solicitudes

Negociación Markdown de la página de inicio

curl https://lobbystack.com/es/ \
  -H "Accept: text/markdown"

Catálogo de API

curl https://lobbystack.com/.well-known/api-catalog \
  -H "Accept: application/linkset+json"

Recursos relacionados