{
  "openapi": "3.1.0",
  "info": {
    "title": "Gymnázium Vavrinca Benedikta Nedožerského (GVBN) API",
    "version": "1.0.0",
    "description": "Oficiálne verejné strojovo čitateľné rozhranie pre vyhľadávanie, študijné odbory, oznamy a dokumenty Gymnázia V. B. Nedožerského v Prievidzi.",
    "contact": {
      "name": "GVBN Prievidza",
      "url": "https://www.gympd.sk",
      "email": "skola@gympd.sk"
    },
    "license": {
      "name": "Open Data CC-BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    }
  },
  "servers": [
    {
      "url": "https://www.gympd.sk",
      "description": "Produkčný server gympd.sk"
    }
  ],
  "paths": {
    "/data/search-index.json": {
      "get": {
        "summary": "Kompletný vyhľadávací index školy",
        "description": "Vráti vyše 300 pre-indexovaných záznamov stránok, učiteľov, krúžkov, udalostí a noviniek.",
        "operationId": "getSearchIndex",
        "responses": {
          "200": {
            "description": "Pole indexovaných entít",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": { "type": "string" },
                      "title": { "type": "string" },
                      "url": { "type": "string" },
                      "category": { "type": "string" },
                      "type": { "type": "string" },
                      "description": { "type": "string" },
                      "tags": { "type": "array", "items": { "type": "string" } }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/feed.json": {
      "get": {
        "summary": "JSON Feed noviniek školy",
        "description": "Štandardný JSON Feed (JSON Feed v1.1) s najnovšími článkami a oznamami.",
        "operationId": "getNewsFeed",
        "responses": {
          "200": {
            "description": "JSON Feed objekt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "version": { "type": "string" },
                    "title": { "type": "string" },
                    "home_page_url": { "type": "string" },
                    "feed_url": { "type": "string" },
                    "items": { "type": "array", "items": { "type": "object" } }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/school.jsonld": {
      "get": {
        "summary": "Schema.org štruktúrované dáta",
        "description": "Kompletná definícia vzdelávacej inštitúcie, vedenia školy, adries a odborov v JSON-LD.",
        "operationId": "getSchoolJsonLd",
        "responses": {
          "200": {
            "description": "Schema.org graf",
            "content": {
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/auth.md": {
      "get": {
        "summary": "Špecifikácia autentifikácie pre AI agentov",
        "description": "Pravidlá prístupu, WorkOS auth.md a informácie o anonymnom čítaní.",
        "operationId": "getAuthMd",
        "responses": {
          "200": {
            "description": "Markdown špecifikácia autentifikácie",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}