Documentation de l’API publique

Ressources de découverte

• /.well-known/api-catalog publie un catalogue Linkset pour la découverte de l’API publique.
• /.well-known/agent-skills/index.json publie un index Agent Skills Discovery RFC v0.2.0 des compétences que ce site met à disposition des agents compatibles.
• /openapi.json publie la description de service OpenAPI référencée par le catalogue d’API.
• /.well-known/mcp/server-card.json publie une MCP Server Card pour la découverte des agents, avec l’identité du serveur Peptaura, la version de protocole prise en charge, le point de terminaison de transport et les capacités annoncées.
• /.well-known/mcp-server-card sert la même MCP Server Card sur le nouveau chemin de compatibilité utilisé par le brouillon SEP actif.
• /mcp expose un transport MCP HTTP Streamable public qui prend actuellement en charge l’initialisation, le ping et des réponses vides de découverte d’outils, de ressources et de prompts pour les clients agents.
• /.well-known/http-message-signatures-directory publie le JWKS Web Bot Auth du site pour les requêtes de bots et d’agents signées.
• /.well-known/openid-configuration redirige vers le document de découverte OpenID Connect canonique de Supabase Auth utilisé pour l’authentification des agents et des clients OAuth.
• /.well-known/oauth-authorization-server redirige les clients orientés OAuth vers le même document de découverte Supabase Auth actif actuellement servi pour OpenID Connect.
• /.well-known/oauth-protected-resource publie les métadonnées de ressource protégée RFC 9728 avec l’identifiant de ressource de ce site, l’émetteur Supabase Auth et les portées OAuth/OIDC prises en charge que les agents doivent demander.
• /llms.txt fournit aux agents un contexte supplémentaire lisible par machine à l’échelle du site.
• Les pages HTML publiques prennent également en charge Cloudflare Markdown for Agents. Envoyez Accept: text/markdown au nom d’hôte de production pour recevoir une représentation Markdown avec une réponse Content-Type: text/markdown et un en-tête x-markdown-tokens lorsque Cloudflare en fournit un.

Intégration de laboratoire

/docs/lab-integration.md est le guide partenaire des laboratoires d’essais approuvés. Il documente le POST sortant facultatif que Peptaura envoie au propre récepteur HTTPS du laboratoire après confirmation d’un paiement au laboratoire, le flux authentifié de téléversement de résultats /lab et l’API partenaire entrante limitée au laboratoire : GET /api/lab/v1/orders/{clientOrderReference} pour la recherche de commandes et POST /api/lab/v1/orders/{clientOrderReference}/results pour l’envoi de rapports multiparties. Les points de terminaison entrants exigent un justificatif Bearer émis par le laboratoire et n’exposent que les propres commandes payées de ce laboratoire ; ce sont des surfaces partenaires, et non des points de terminaison publics non authentifiés comme ceux ci-dessous.