{
  "openapi": "3.1.0",
  "info": {
    "title": "Quizard Public Content API",
    "version": "1.0.0",
    "description": "Discovery description of Quizard's public, unauthenticated content and metadata endpoints. These endpoints are intended for AI agents, crawlers, and answer engines to retrieve clean, machine-readable representations of the site. Application/gameplay APIs are internal and not part of this catalog.",
    "contact": {
      "name": "Quizard",
      "url": "https://quizard.live"
    }
  },
  "servers": [
    {
      "url": "https://quizard.live",
      "description": "Production"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "operationId": "getHomepage",
        "summary": "Homepage",
        "description": "Returns the HTML homepage. Sends text/markdown instead when the request carries `Accept: text/markdown` or the `?format=md` query parameter.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "Set to `md` to receive the markdown representation.",
            "schema": { "type": "string", "enum": ["md"] }
          }
        ],
        "responses": {
          "200": {
            "description": "Homepage content",
            "content": {
              "text/html": {},
              "text/markdown": {}
            }
          }
        }
      }
    },
    "/index.md": {
      "get": {
        "operationId": "getHomepageMarkdown",
        "summary": "Homepage as markdown",
        "description": "Clean markdown summary of Quizard including an FAQ and links to key pages.",
        "responses": {
          "200": {
            "description": "Markdown document",
            "content": { "text/markdown": {} }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "llms.txt",
        "description": "Structured llms.txt file (per llmstxt.org) listing LLM-friendly resources.",
        "responses": {
          "200": {
            "description": "llms.txt document",
            "content": { "text/markdown": {} }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "operationId": "getSitemap",
        "summary": "XML sitemap",
        "responses": {
          "200": {
            "description": "URL set",
            "content": { "application/xml": {} }
          }
        }
      }
    },
    "/robots.txt": {
      "get": {
        "operationId": "getRobots",
        "summary": "robots.txt",
        "description": "Crawler directives, including an explicit AI bot policy.",
        "responses": {
          "200": {
            "description": "robots.txt",
            "content": { "text/plain": {} }
          }
        }
      }
    }
  }
}