LobbyStack

Documentation API publique

LobbyStack expose une petite surface de découverte publique afin que les agents trouvent la documentation, le statut, les métadonnées OpenAPI, les skills et les préférences lisibles par machine sans scraper le site.

Ces endpoints publics ne demandent pas d’authentification. Les métadonnées OAuth seront publiées sur l’hôte applicatif lorsque les API protégées exposeront de vrais endpoints d’autorisation.

À qui s’adresse cette surface de découverte

Ces endpoints aident les développeurs, moteurs de recherche, agents IA, lecteurs de flux et outils d’intégration à trouver la documentation publique et les ressources lisibles par machine de LobbyStack. Ils ne constituent pas un plan de contrôle authentifié pour les comptes ou appels clients.

Accès et comportement des réponses

  • • Les endpoints publics de découverte acceptent les requêtes GET ou HEAD sans authentification.
  • • L’endpoint de statut indique la santé publique du service sans exposer de données opérationnelles ou de locataire.
  • • Les API applicatives protégées sont documentées séparément et utilisent la méthode d’authentification publiée par l’hôte applicatif.
  • • La page d’accueil prend en charge la négociation Accept: text/markdown; les autres représentations Markdown publiées sont disponibles aux endpoints .md indiqués ci-dessous.

Endpoints de découverte

EndpointType de contenuObjectif
/.well-known/api-catalog application/linkset+json Linkset du catalogue API.
/openapi.json application/vnd.oai.openapi+json Description OpenAPI du service.
/llms.txt text/plain Contexte compact produit, fonctionnalités, tarifs et découverte pour les LLM.
/feed.xml application/rss+xml Flux RSS complet pour la découverte du blog.
/schemamap.xml application/xml Carte de découverte des données structurées.
/schema/page.json application/ld+json Graphe JSON-LD des pages publiques.
/schema/post.json application/ld+json Graphe JSON-LD des articles de blog.
/fr/index.md text/markdown Résumé de la page d’accueil en markdown.
/fr/features.md text/markdown Résumé des fonctionnalités en markdown.
/fr/pricing.md text/markdown Tarifs, volume inclus, règles et dépassements en markdown.
/.well-known/agent-skills/index.json application/json Index de découverte des agent skills.
/.well-known/mcp/server-card.json application/json Carte serveur MCP.

Exemples de requêtes

Négociation Markdown de l’accueil

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

Catalogue API

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

Ressources associées