Offentlig API-dokumentation

Opdagelsesressourcer

• /.well-known/api-catalog udgiver et Linkset-katalog til offentlig API-opdagelse.
• /.well-known/agent-skills/index.json udgiver et Agent Skills Discovery RFC v0.2.0-indeks for de færdigheder, som dette websted stiller til rådighed for kompatible agenter.
• /openapi.json udgiver OpenAPI-tjenestebeskrivelsen, som API-kataloget henviser til.
• /.well-known/mcp/server-card.json udgiver et MCP Server Card til agentopdagelse, herunder Peptaura-serverens identitet, understøttet protokolversion, transportslutpunkt og annoncerede funktioner.
• /.well-known/mcp-server-card leverer det samme MCP Server Card på den nyere kompatibilitetssti, som bruges af det aktive SEP-udkast.
• /mcp eksponerer en offentlig Streamable HTTP MCP-transport, som i øjeblikket understøtter initialisering, ping og tomme svar for opdagelse af værktøjer/ressourcer/prompter for agentklienter.
• /.well-known/http-message-signatures-directory udgiver webstedets Web Bot Auth JWKS til signerede bot- og agentanmodninger.
• /.well-known/openid-configuration omdirigerer til det kanoniske Supabase Auth OpenID Connect-opdagelsesdokument, der bruges til godkendelse af agenter og OAuth-klienter.
• /.well-known/oauth-authorization-server omdirigerer OAuth-orienterede klienter til det samme aktive Supabase Auth-opdagelsesdokument, som i øjeblikket bruges til OpenID Connect.
• /.well-known/oauth-protected-resource udgiver RFC 9728-metadata for beskyttede ressourcer med dette websteds ressourceidentifikator, Supabase Auth-udstederen og de OAuth/OIDC-scopes, som agenter bør anmode om.
• /llms.txt giver yderligere maskinlæsbar kontekst på webstedsniveau til agenter.
• Offentlige HTML-sider understøtter også Cloudflare Markdown for Agents. Send Accept: text/markdown til produktionsværtsnavnet for at modtage en markdown-repræsentation med et Content-Type: text/markdown -svar og en x-markdown-tokens -header, når Cloudflare leverer en.

Laboratorieintegration

/docs/lab-integration.md er partnerguiden for godkendte testlaboratorier. Den dokumenterer det valgfri udgående POST-kald, som Peptaura sender til laboratoriets egen HTTPS-modtager, efter at en laboratorieudbetaling er bekræftet, det godkendte /lab-flow til resultatupload og det laboratorieafgrænsede indgående partner-API: GET /api/lab/v1/orders/{clientOrderReference} ordreopslag og POST /api/lab/v1/orders/{clientOrderReference}/results multipart-rapportindsendelse. De indgående slutpunkter kræver en laboratorieudstedt Bearer-legitimationsoplysning og eksponerer kun laboratoriets egne betalte ordrer. De er partnerflader, ikke uautentiserede offentlige slutpunkter som dem nedenfor.