{
  "openapi": "3.1.0",
  "info": {
    "title": "EzAuto Public Content API",
    "version": "1.0.0",
    "summary": "Read-only access to EzAuto's public website content for AI agents and crawlers.",
    "description": "EzAuto is a South African rent-to-own vehicle provider. This description covers only the publicly crawlable content surfaces of ezauto.co.za. Vehicle stock, pricing engines, application intake and customer data are private and are intentionally not described here — see /api-docs for how partners request access.",
    "contact": {
      "name": "EzAuto",
      "url": "https://ezauto.co.za/contact",
      "email": "info@ezauto.co.za"
    },
    "termsOfService": "https://ezauto.co.za/terms-of-use",
    "license": {
      "name": "All rights reserved",
      "url": "https://ezauto.co.za/terms-of-use"
    }
  },
  "servers": [
    {
      "url": "https://ezauto.co.za",
      "description": "Production website"
    }
  ],
  "paths": {
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsIndex",
        "summary": "Agent content map",
        "description": "Curated index of EzAuto's public pages and guides, formatted for AI agents.",
        "responses": {
          "200": {
            "description": "Plain-text content map",
            "content": {
              "text/plain": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLlmsFull",
        "summary": "Expanded agent content map",
        "description": "Longer content map including guides, location hubs and monthly price hubs.",
        "responses": {
          "200": {
            "description": "Plain-text content map",
            "content": {
              "text/plain": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "operationId": "getSitemapIndex",
        "summary": "Sitemap index",
        "description": "Sitemap index referencing the page, location, brand, vehicle and blog sitemaps.",
        "responses": {
          "200": {
            "description": "XML sitemap index",
            "content": {
              "application/xml": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/robots.txt": {
      "get": {
        "operationId": "getRobots",
        "summary": "Crawler policy",
        "responses": {
          "200": {
            "description": "Robots policy",
            "content": {
              "text/plain": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "operationId": "getApiCatalog",
        "summary": "API catalog (RFC 9727)",
        "responses": {
          "200": {
            "description": "Linkset describing EzAuto's machine-readable resources",
            "content": {
              "application/linkset+json": { "schema": { "type": "object" } }
            }
          }
        }
      }
    },
    "/.well-known/agent-card.json": {
      "get": {
        "operationId": "getAgentCard",
        "summary": "A2A agent card",
        "responses": {
          "200": {
            "description": "Agent card document",
            "content": {
              "application/json": { "schema": { "type": "object" } }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "operationId": "getAgentSkills",
        "summary": "Agent skills discovery index",
        "responses": {
          "200": {
            "description": "Skills index with digests",
            "content": {
              "application/json": { "schema": { "type": "object" } }
            }
          }
        }
      }
    }
  },
  "components": {}
}
