{
  "openapi": "3.1.0",
  "info": {
    "title": "Football Masters — Agent-Ready API",
    "version": "0.1.0",
    "description": "Read-only endpointy dla agentów AI, LLMs i tools. Katalog rękawic bramkarskich + content w Markdown i structured JSON. Zakładka rękawic (kupno): https://footballmasters.pl/pl/menu/sklep/rekawice-bramkarskie-863.html",
    "contact": {
      "name": "Football Masters",
      "email": "kontakt@footballmasters.pl",
      "url": "https://footballmasters.pl"
    },
    "license": {
      "name": "Agent read-only",
      "url": "https://ai.footballmasters.pl/robots.txt"
    }
  },
  "servers": [
    { "url": "https://ai.footballmasters.pl", "description": "Production" }
  ],
  "paths": {
    "/api/products.json": {
      "get": {
        "summary": "Katalog produktów",
        "description": "Zwraca structured katalog rękawic bramkarskich FM (6 modeli, rodzin, specyfikacji, ceny udokumentowane).",
        "responses": {
          "200": {
            "description": "Catalog",
            "content": { "application/json": {} }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "LLM index",
        "responses": { "200": { "description": "Plain text llms.txt" } }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Pełna treść w jednym pliku (dla RAG)",
        "responses": { "200": { "description": "Plain text full content" } }
      }
    },
    "/products/{slug}.md": {
      "get": {
        "summary": "Szczegóły modelu",
        "parameters": [{
          "name": "slug",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "enum": ["varis-x", "varis-x-pro", "invictus-x", "invictus-x-pro", "invictus-x-junior", "invictus-x-training"]
          }
        }],
        "responses": { "200": { "description": "Markdown" } }
      }
    },
    "/guides/{slug}.md": {
      "get": {
        "summary": "Przewodnik edukacyjny",
        "parameters": [{
          "name": "slug",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "enum": ["jak-wybrac-rekawice", "jak-dbac-o-rekawice", "kiedy-wymienic-rekawice"]
          }
        }],
        "responses": { "200": { "description": "Markdown" } }
      }
    },
    "/policies/{slug}.md": {
      "get": {
        "summary": "Polityki sklepu",
        "parameters": [{
          "name": "slug",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "enum": ["shipping", "returns", "warranty"]
          }
        }],
        "responses": { "200": { "description": "Markdown" } }
      }
    },
    "/faq.md": {
      "get": {
        "summary": "FAQ",
        "responses": { "200": { "description": "Markdown" } }
      }
    },
    "/about.md": {
      "get": {
        "summary": "O firmie",
        "responses": { "200": { "description": "Markdown" } }
      }
    }
  },
  "externalDocs": {
    "description": "Sklep dla ludzi (zakładka rękawic)",
    "url": "https://footballmasters.pl/pl/menu/sklep/rekawice-bramkarskie-863.html"
  }
}