Dokumentacija javnog API-ja

LobbyStack nudi malu javnu površinu za otkrivanje kako bi agenti pronašli dokumentaciju, status, OpenAPI metapodatke, skills i mašinski čitljiva pravila korišćenja bez preuzimanja sadržaja sa sajta.

Ovi javni endpointi za otkrivanje ne zahtevaju autentifikaciju. OAuth metapodaci biće objavljeni na hostu aplikacije kada zaštićeni API-ji budu imali prave endpointe za autorizaciju.

Kome je namenjena ova površina za otkrivanje

Ovi endpointi pomažu programerima, pretraživačima, AI agentima, RSS čitačima i alatima za integraciju da pronađu javnu dokumentaciju i mašinski čitljive resurse o proizvodu LobbyStack. To su interfejsi za otkrivanje, a ne autentifikovani kontrolni sloj za pozive ili naloge klijenata.

Pristup i ponašanje odgovora

  • • Javni endpointi za otkrivanje prihvataju GET ili HEAD zahteve bez autentifikacije.
  • • Endpoint za status prikazuje javno stanje servisa; ne otkriva podatke o klijentima niti operativne podatke.
  • • Zaštićeni API-ji aplikacije dokumentovani su posebno i zahtevaju metod autentifikacije koji objavljuje host aplikacije.
  • • Početna stranica podržava pregovaranje Accept: text/markdown; ostale objavljene Markdown verzije dostupne su na .md endpointima navedenim ispod.

Endpointi za otkrivanje

EndpointTip sadržajaNamena
/.well-known/api-catalogapplication/linkset+jsonLinkset API kataloga.
/openapi.jsonapplication/vnd.oai.openapi+jsonOpenAPI opis servisa.
/llms.txttext/plainSažet kontekst o proizvodu, funkcijama, cenama i otkrivanju za LLM modele.
/feed.xmlapplication/rss+xmlRSS feed sa celim sadržajem bloga.
/schemamap.xmlapplication/xmlMapa endpointa sa strukturiranim podacima.
/schema/page.jsonapplication/ld+jsonJSON-LD graf javnih stranica.
/schema/post.jsonapplication/ld+jsonJSON-LD graf članaka na blogu.
/sr/index.mdtext/markdownRezime početne stranice u markdown formatu.
/sr/features.mdtext/markdownRezime funkcija u markdown formatu.
/sr/pricing.mdtext/markdownCene, uključena potrošnja, pravila potrošnje i cene prekoračenja u markdown formatu.
/.well-known/agent-skills/index.jsonapplication/jsonIndeks za otkrivanje agent skills resursa.
/.well-known/mcp/server-card.jsonapplication/jsonKartica MCP servera.

Primeri zahteva

Markdown pregovaranje za početnu stranicu

curl https://lobbystack.com/sr/ \
  -H "Accept: text/markdown"

API katalog

curl https://lobbystack.com/.well-known/api-catalog \
  -H "Accept: application/linkset+json"

Povezani resursi