Julkinen API-dokumentaatio

Löytämisresurssit

• /.well-known/api-catalog julkaisee Linkset-luettelon julkista API-löytämistä varten.
• /.well-known/agent-skills/index.json julkaisee Agent Skills Discovery RFC v0.2.0 -hakemiston taidoista, jotka tämä sivusto tarjoaa yhteensopiville agenteille.
• /openapi.json julkaisee API-luettelon viittaaman OpenAPI-palvelukuvauksen.
• /.well-known/mcp/server-card.json julkaisee agenttien löytämistä varten MCP-palvelinkortin, joka sisältää Peptaura-palvelimen tunnistetiedot, tuetun protokollaversion, siirron päätepisteen ja ilmoitetut ominaisuudet.
• /.well-known/mcp-server-card tarjoaa saman MCP-palvelinkortin aktiivisen SEP-luonnoksen käyttämässä uudemmassa yhteensopivuuspolussa.
• /mcp tarjoaa julkisen Streamable HTTP MCP -siirtoyhteyden, joka tukee tällä hetkellä alustusta, pingiä sekä tyhjiä työkalu-, resurssi- ja kehotehakuvastauksia agenttiasiakkaille.
• /.well-known/http-message-signatures-directory julkaisee sivuston Web Bot Auth JWKS:n allekirjoitettuja botti- ja agenttipyyntöjä varten.
• /.well-known/openid-configuration ohjaa kanoniseen Supabase Auth OpenID Connect -löytöasiakirjaan, jota käytetään agenttien ja OAuth-asiakkaiden todennuksessa.
• /.well-known/oauth-authorization-server ohjaa OAuth-painotteiset asiakkaat samaan tuotannossa olevaan Supabase Auth -löytöasiakirjaan, joka tarjotaan tällä hetkellä OpenID Connectille.
• /.well-known/oauth-protected-resource julkaisee RFC 9728 -suojatun resurssin metatiedot, joissa ovat tämän sivuston resurssitunniste, Supabase Auth -myöntäjä ja tuetut OAuth/OIDC-laajuudet, joita agenttien tulee pyytää.
• /llms.txt tarjoaa agenteille lisäkontekstia sivustotasolla koneellisesti luettavassa muodossa.
• Julkiset HTML-sivut tukevat myös Cloudflare Markdown for Agents -muotoa. Lähetä Accept: text/markdown tuotannon isäntänimeen saadaksesi Markdown-esityksen, jossa on Content-Type: text/markdown vastaus ja x-markdown-tokens otsake silloin, kun Cloudflare tarjoaa sellaisen.

Laboratoriointegraatio

/docs/lab-integration.md on hyväksyttyjen testauslaboratorioiden kumppaniopas. Siinä dokumentoidaan valinnainen lähtevä POST-pyyntö, jonka Peptaura lähettää laboratorion omaan HTTPS-vastaanottimeen, kun laboratorion maksu on vahvistettu, todennettu /lab-tulostenlatausvirta sekä laboratoriokohtainen saapuva kumppani-API: GET /api/lab/v1/orders/{clientOrderReference} tilaushaku ja POST /api/lab/v1/orders/{clientOrderReference}/results moniosainen raportin lähetys. Saapuvat päätepisteet edellyttävät laboratorion myöntämää Bearer-tunnistetta ja paljastavat vain kyseisen laboratorion omat maksetut tilaukset. Ne ovat kumppanipintoja, eivät todennuksettomia julkisia päätepisteitä kuten alla olevat.