{
  "openapi": "3.1.0",
  "info": {
    "title": "404 Privacy Public Content API",
    "version": "1.0.0",
    "description": "Machine-readable discovery and Markdown representations of public 404 Privacy content."
  },
  "servers": [
    {
      "url": "https://404privacy.com"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "summary": "Retrieve the 404 Privacy homepage",
        "description": "Returns HTML by default. Send Accept: text/markdown for a formatting-stripped Markdown representation.",
        "responses": {
          "200": {
            "description": "Homepage representation",
            "headers": {
              "Link": {
                "description": "Links to the API catalog, service description, and documentation.",
                "schema": { "type": "string" }
              },
              "x-markdown-tokens": {
                "description": "Estimated token count, present on Markdown responses.",
                "schema": { "type": "integer" }
              }
            },
            "content": {
              "text/html": { "schema": { "type": "string" } },
              "text/markdown": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "Retrieve the RFC 9727 API catalog",
        "responses": {
          "200": {
            "description": "RFC 9264 JSON linkset document",
            "content": {
              "application/linkset+json": {
                "schema": {
                  "type": "object",
                  "required": ["linkset"],
                  "properties": {
                    "linkset": { "type": "array", "items": { "type": "object" } }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}