Offentlig API-dokumentasjon

Oppdagelsesressurser

• /.well-known/api-catalog publiserer en Linkset-katalog for offentlig API-oppdagelse.
• /.well-known/agent-skills/index.json publiserer en Agent Skills Discovery RFC v0.2.0-indeks for ferdighetene dette nettstedet gjør tilgjengelig for kompatible agenter.
• /openapi.json publiserer OpenAPI-tjenestebeskrivelsen som API-katalogen viser til.
• /.well-known/mcp/server-card.json publiserer et MCP Server Card for agentoppdagelse, inkludert Peptaura-serverens identitet, støttet protokollversjon, transportendepunkt og annonserte funksjoner.
• /.well-known/mcp-server-card tilbyr det samme MCP Server Card på den nyere kompatibilitetsstien som brukes av det aktive SEP-utkastet.
• /mcp eksponerer en offentlig Streamable HTTP MCP-transport som for tiden støtter initialisering, ping og tomme svar for oppdagelse av verktøy/ressurser/prompter for agentklienter.
• /.well-known/http-message-signatures-directory publiserer nettstedets Web Bot Auth JWKS for signerte bot- og agentforespørsler.
• /.well-known/openid-configuration omdirigerer til det kanoniske Supabase Auth OpenID Connect-oppdagelsesdokumentet som brukes for autentisering av agenter og OAuth-klienter.
• /.well-known/oauth-authorization-server omdirigerer OAuth-orienterte klienter til det samme aktive Supabase Auth-oppdagelsesdokumentet som for tiden brukes for OpenID Connect.
• /.well-known/oauth-protected-resource publiserer RFC 9728-metadata for beskyttede ressurser med dette nettstedets ressursidentifikator, Supabase Auth-utstederen og OAuth/OIDC-omfangene agenter bør be om.
• /llms.txt gir ytterligere maskinlesbar kontekst på nettstednivå for agenter.
• Offentlige HTML-sider støtter også Cloudflare Markdown for Agents. Send Accept: text/markdown til produksjonsvertsnavnet for å motta en markdown-representasjon med en Content-Type: text/markdown -svar og en x-markdown-tokens -overskrift når Cloudflare leverer en.

Laboratorieintegrasjon

/docs/lab-integration.md er partnerveiledningen for godkjente testlaboratorier. Den dokumenterer det valgfrie utgående POST-kallet som Peptaura sender til laboratoriets egen HTTPS-mottaker etter at en laboratorieutbetaling er bekreftet, den autentiserte /lab-flyten for resultatopplasting og det laboratorieavgrensede inngående partner-API-et: GET /api/lab/v1/orders/{clientOrderReference} ordreoppslag og POST /api/lab/v1/orders/{clientOrderReference}/results multipart-rapportinnsending. De inngående endepunktene krever en laboratorieutstedt Bearer-legitimasjon og eksponerer bare laboratoriets egne betalte ordrer. De er partnerflater, ikke uautentiserte offentlige endepunkter som dem nedenfor.