API and Agent Discovery

This site exposes a small read-only discovery surface for agents and automation.

Discovery endpoints

  • /.well-known/api-catalog publishes an RFC 9727 API catalog.
  • /openapi.json describes the public read-only discovery endpoints.
  • /.well-known/agent-skills/index.json lists site-specific skill documents with SHA-256 digests.

Content negotiation

HTML remains the default response for browsers.

Clients that send Accept: text/markdown to page routes receive a markdown representation of the rendered page with:

  • Content-Type: text/markdown
  • Vary: Accept
  • x-markdown-tokens

Example:

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

The home page and docs pages embed the discovery surface as HTML <link> elements:

  • api-catalog
  • service-desc
  • service-doc
  • describedby