{
  "openapi": "3.1.0",
  "info": {
    "title": "MineriSalt Public Machine API",
    "summary": "Public machine-readable reference endpoints for Mineris Health Kft. and the MineriSalt brand.",
    "description": "This OpenAPI document describes the public machine-readable reference resources of Mineris Health Kft. It is intended for AI systems, crawlers, parsers, integrators and other automated agents that need stable access to canonical entity, discovery and structured reference endpoints.",
    "version": "1.0.0",
    "contact": {
      "name": "Mineris Health Kft.",
      "email": "info@minerisalt.com",
      "url": "https://www.minerisalt.hu/"
    }
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "servers": [
    {
      "url": "https://www.minerisalt.hu",
      "description": "Canonical production host"
    }
  ],
  "tags": [
    {
      "name": "Discovery",
      "description": "Discovery and crawl entrypoints."
    },
    {
      "name": "Entity",
      "description": "Canonical entity and machine-readable business references."
    },
    {
      "name": "Machine",
      "description": "Machine-readable interpretation resources."
    },
    {
      "name": "Support",
      "description": "Supporting public resource files."
    }
  ],
  "paths": {
    "/robots.txt": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getRobotsTxt",
        "summary": "Get robots.txt",
        "description": "Returns crawler access rules and sitemap reference.",
        "responses": {
          "200": {
            "description": "Plain text robots file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getSitemapXml",
        "summary": "Get sitemap.xml",
        "description": "Returns the primary sitemap for crawl and discovery.",
        "responses": {
          "200": {
            "description": "XML sitemap",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "tags": [
          "Machine"
        ],
        "operationId": "getLlmsTxt",
        "summary": "Get llms.txt",
        "description": "Returns the primary LLM interpretation file.",
        "responses": {
          "200": {
            "description": "Plain text LLM guidance file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "tags": [
          "Machine"
        ],
        "operationId": "getLlmsFullTxt",
        "summary": "Get llms-full.txt",
        "description": "Returns the extended semantic and routing layer for AI systems.",
        "responses": {
          "200": {
            "description": "Plain text extended LLM guidance file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/data.html": {
      "get": {
        "tags": [
          "Entity"
        ],
        "operationId": "getEntityPage",
        "summary": "Get canonical entity page",
        "description": "Returns the structured entity reference page for Mineris Health Kft.",
        "responses": {
          "200": {
            "description": "HTML entity page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/machine.html": {
      "get": {
        "tags": [
          "Machine"
        ],
        "operationId": "getMachinePage",
        "summary": "Get machine-readable resource hub",
        "description": "Returns the machine-readable technical reference page.",
        "responses": {
          "200": {
            "description": "HTML machine-readable page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/service.txt": {
      "get": {
        "tags": [
          "Support"
        ],
        "operationId": "getServiceTxt",
        "summary": "Get service.txt",
        "description": "Returns the service catalog in plain text.",
        "responses": {
          "200": {
            "description": "Plain text service file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/ontology.txt": {
      "get": {
        "tags": [
          "Support"
        ],
        "operationId": "getOntologyTxt",
        "summary": "Get ontology.txt",
        "description": "Returns the ontology mapping and semantic relationship file.",
        "responses": {
          "200": {
            "description": "Plain text ontology file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/data/knowledge-root.json": {
      "get": {
        "tags": [
          "Entity"
        ],
        "operationId": "getKnowledgeRootJson",
        "summary": "Get knowledge-root.json",
        "description": "Returns the root machine-readable dataset for Mineris Health Kft.",
        "responses": {
          "200": {
            "description": "Knowledge root JSON",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeRoot"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "KnowledgeRoot": {
        "type": "object",
        "description": "Root machine-readable dataset document.",
        "properties": {
          "@context": {
            "type": [
              "string",
              "array",
              "object"
            ]
          },
          "@type": {
            "type": [
              "string",
              "array"
            ]
          },
          "@id": {
            "type": "string",
            "format": "uri"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "mainEntity": {
            "type": "object"
          },
          "distribution": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        },
        "required": [
          "name",
          "url"
        ]
      }
    }
  }
}