Documentação da API pública

Recursos de descoberta

• /.well-known/api-catalog publica um catálogo Linkset para descoberta pública da API.
• /.well-known/agent-skills/index.json publica um índice Agent Skills Discovery RFC v0.2.0 das habilidades que este site disponibiliza a agentes compatíveis.
• /openapi.json publica a descrição do serviço OpenAPI referenciada pelo catálogo de API.
• /.well-known/mcp/server-card.json publica um MCP Server Card para descoberta de agentes, incluindo a identidade do servidor Peptaura, a versão de protocolo compatível, o endpoint de transporte e os recursos anunciados.
• /.well-known/mcp-server-card disponibiliza o mesmo MCP Server Card no caminho de compatibilidade mais recente usado pelo rascunho SEP ativo.
• /mcp expõe um transporte MCP HTTP Streamable público que atualmente suporta inicialização, ping e respostas vazias de descoberta de ferramentas, recursos e prompts para clientes de agentes.
• /.well-known/http-message-signatures-directory publica o JWKS de Web Bot Auth do site para solicitações assinadas de bots e agentes.
• /.well-known/openid-configuration redireciona ao documento canônico de descoberta OpenID Connect do Supabase Auth usado para autenticação de agentes e clientes OAuth.
• /.well-known/oauth-authorization-server redireciona clientes voltados a OAuth para o mesmo documento ativo de descoberta do Supabase Auth atualmente servido para OpenID Connect.
• /.well-known/oauth-protected-resource publica metadados de recurso protegido RFC 9728 com o identificador de recurso deste site, o emissor do Supabase Auth e os escopos OAuth/OIDC compatíveis que os agentes devem solicitar.
• /llms.txt fornece contexto adicional legível por máquina no nível do site para agentes.
• As páginas HTML públicas também oferecem suporte ao Cloudflare Markdown for Agents. Envie Accept: text/markdown ao nome de host de produção para receber uma representação em Markdown com uma resposta Content-Type: text/markdown e um cabeçalho x-markdown-tokens quando a Cloudflare disponibilizar um.

Integração de laboratório

/docs/lab-integration.md é o guia de parceiros para laboratórios de testes aprovados. Ele documenta o POST de saída opcional que a Peptaura envia ao próprio receptor HTTPS do laboratório após a confirmação de um pagamento ao laboratório, o fluxo autenticado de envio de resultados em /lab e a API de parceiros de entrada com escopo de laboratório: GET /api/lab/v1/orders/{clientOrderReference} para consulta de pedidos e POST /api/lab/v1/orders/{clientOrderReference}/results para envio de relatórios multipartes. Os endpoints de entrada exigem uma credencial Bearer emitida pelo laboratório e expõem apenas os próprios pedidos pagos desse laboratório; são superfícies de parceiros, não endpoints públicos sem autenticação como os abaixo.