公开 API 文档

发现资源

• /.well-known/api-catalog 发布用于公开 API 发现的 Linkset 目录。
• /.well-known/agent-skills/index.json 发布 Agent Skills Discovery RFC v0.2.0 索引，列出本站向兼容智能体提供的技能。
• /openapi.json 发布 API 目录所引用的 OpenAPI 服务描述。
• /.well-known/mcp/server-card.json 发布用于智能体发现的 MCP Server Card，包括 Peptaura 服务器身份、支持的协议版本、传输端点及公布的能力。
• /.well-known/mcp-server-card 在当前 SEP 草案所使用的较新兼容路径上提供相同的 MCP Server Card。
• /mcp 提供公开的 Streamable HTTP MCP 传输，目前支持面向智能体客户端的初始化、ping，以及空的工具/资源/提示词发现响应。
• /.well-known/http-message-signatures-directory 发布本站用于签名机器人和智能体请求的 Web Bot Auth JWKS。
• /.well-known/openid-configuration 重定向至规范的 Supabase Auth OpenID Connect 发现文档，用于智能体和 OAuth 客户端身份验证。
• /.well-known/oauth-authorization-server 将面向 OAuth 的客户端重定向至当前为 OpenID Connect 提供的同一份实时 Supabase Auth 发现文档。
• /.well-known/oauth-protected-resource 发布 RFC 9728 受保护资源元数据，包含本站的资源标识符、Supabase Auth 签发方，以及智能体应请求的受支持 OAuth/OIDC 范围。
• /llms.txt 为智能体提供额外的站点级机器可读上下文。
• 公开 HTML 页面还支持 Cloudflare Markdown for Agents。将 Accept: text/markdown 发送至生产主机名，即可获得 Markdown 格式的内容，并附带 Content-Type: text/markdown 响应以及 x-markdown-tokens 标头（如 Cloudflare 提供）。

实验室集成

/docs/lab-integration.md 是面向经批准检测实验室的合作伙伴指南。其中说明了在实验室款项确认支付后，Peptaura 向实验室自有 HTTPS 接收端发送的可选出站 POST、经身份验证的 /lab 结果上传流程，以及限定于该实验室的入站合作伙伴 API： GET /api/lab/v1/orders/{clientOrderReference} 订单查询，以及 POST /api/lab/v1/orders/{clientOrderReference}/results multipart 报告提交。入站端点需要实验室签发的 Bearer 凭证，且仅公开该实验室自己的已付款订单——它们是合作伙伴接口，而非下方那类无需身份验证的公开端点。