Khazar University VETMED

Public content APIs, discovery metadata and browser tools for agents.

This site publishes discovery headers, a dynamic sitemap, Markdown negotiation, public content APIs, OAuth metadata and browser-exposed tools so automated agents can discover, search and traverse the VETMED experience without scraping brittle page chrome.

Open OpenAPI Inspect API catalog

Discovery

Discovery Surface

Endpoint

API Catalog

RFC 9727 linkset document that connects the public content API, OpenAPI description and human docs.

/.well-known/api-catalog

Endpoint

OpenAPI

Machine-readable schema for public search, latest-content and site discovery endpoints.

/.well-known/openapi.json

Endpoint

Site API

Root discovery document for sections, endpoints, auth metadata and browser-exposed tools.

/.well-known/site-api

Endpoint

Agent Skills

Skill index with digests for navigation, content discovery and browser tool usage notes.

/.well-known/agent-skills/index.json

Endpoint

MCP Card

Self-discovery card that describes the site tools and discovery surface for agents.

/.well-known/mcp/server-card.json

Content API

Public Content Endpoints

Endpoint

Search

Search public news, announcements and events. Query params: q, locale, type, limit.

/api/content/search?q=veterinary&locale=en&type=all

Endpoint

Latest

Return the newest public items in reverse chronological order.

/api/content/latest?locale=en&type=news&limit=5

Endpoint

Markdown Negotiation

HTML routes are rewritten to a markdown representation when agents explicitly negotiate for text/markdown.

/en/news/; send Accept: text/markdown

Endpoint

Sitemap

Dynamic sitemap generated from public route inventory and live CMS-backed detail pages.

/sitemap.xml

Auth

Identity Metadata

Endpoint

OpenID Configuration

OIDC discovery metadata for automated clients and discovery clients.

/.well-known/openid-configuration

Endpoint

OAuth Authorization Server

Authorization server metadata announcing token issuance and supported scopes.

/.well-known/oauth-authorization-server

Endpoint

OAuth Protected Resource

Protected resource metadata for the public site API and its discovery scopes.

/.well-known/oauth-protected-resource

Endpoint

Token Endpoint

Client-credentials token endpoint. Enable it with AGENT_CLIENT_CLIENT_ID and AGENT_CLIENT_CLIENT_SECRET.

/api/auth/token

Example

Minimal discovery walk

curl -I https://example.edu/en/news/

curl https://example.edu/.well-known/api-catalog

curl "https://example.edu/api/content/search?q=veterinary&locale=en&type=all"

curl -H "Accept: text/markdown" https://example.edu/en/news/