{
  "openapi": "3.1.0",
  "info": {
    "title": "UserToMe Portal Open Data & Utility API",
    "description": "Public developer resources, static data endpoints, and utility tools provided by UserToMe (유저투미).",
    "version": "2.0.0",
    "contact": {
      "name": "UserToMe Support",
      "email": "usertome2023@gmail.com",
      "url": "https://portal.userto.me/contact/"
    },
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    }
  },
  "servers": [
    {
      "url": "https://portal.userto.me",
      "description": "Production edge server"
    }
  ],
  "paths": {
    "/data/portal.json": {
      "get": {
        "summary": "Get portal catalog and app directory",
        "description": "Returns full list of available apps, category taxonomy, and deep-link targets.",
        "responses": {
          "200": {
            "description": "Successful retrieval of portal application catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "siteTitle": { "type": "string" },
                    "domain": { "type": "string" },
                    "categories": { "type": "array" },
                    "apps": { "type": "array" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Get LLM and agent guidance manifest",
        "description": "Returns standard llms.txt context document with decision guidance.",
        "responses": {
          "200": {
            "description": "Standard Markdown document",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "summary": "Get full XML sitemap",
        "description": "Returns XML sitemap of all indexable pages including all 403 Seoul dong chicken map pages and 17 regional wealth pages.",
        "responses": {
          "200": {
            "description": "Sitemap XML",
            "content": {
              "application/xml": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    }
  }
}