{
  "openapi": "3.1.0",
  "info": {
    "title": "OrlandoMJ Public Content API",
    "version": "1.1.0",
    "description": "Public, read-only content discovery surface for OrlandoMJ.com — the cannabis dispensary directory for Orlando, Central Florida, and the Space Coast. This document advertises canonical URLs and content collections for AI assistants and answer engines. Real-time inventory, pricing, and transactions are NOT exposed.",
    "contact": {
      "name": "OrlandoMJ Editorial",
      "email": "hello@orlandomj.com",
      "url": "https://orlandomj.com"
    },
    "license": {
      "name": "Editorial content — see Terms of Service",
      "url": "https://orlandomj.com/terms-of-service"
    }
  },
  "servers": [
    { "url": "https://orlandomj.com", "description": "Production" }
  ],
  "externalDocs": {
    "description": "LLMs.txt — AI assistant context",
    "url": "https://orlandomj.com/llms.txt"
  },
  "tags": [
    { "name": "directory", "description": "Operator and listing directory pages" },
    { "name": "best-dispensary", "description": "Ranked 'best dispensary in [city]' AEO answer pages" },
    { "name": "cities", "description": "City-level directory pages (Orlando metro, Space Coast, Central FL)" },
    { "name": "law", "description": "Florida cannabis statute and rule references" },
    { "name": "editorial", "description": "Guides and blog posts" }
  ],
  "paths": {
    "/dispensaries": {
      "get": {
        "tags": ["directory"],
        "summary": "Florida MMTC dispensary directory (Orlando metro + Space Coast + Central FL)",
        "description": "Browseable index of state-licensed Medical Marijuana Treatment Centers serving Orange, Seminole, Osceola, Lake, Brevard, Volusia, Sumter, and Marion counties.",
        "responses": { "200": { "description": "HTML directory page" } }
      }
    },
    "/dispensaries/{operatorSlug}": {
      "get": {
        "tags": ["directory"],
        "summary": "MMTC operator profile",
        "parameters": [{ "name": "operatorSlug", "in": "path", "required": true, "schema": { "type": "string" } }],
        "responses": { "200": { "description": "HTML operator page" } }
      }
    },
    "/dispensaries/{operatorSlug}/{locationSlug}": {
      "get": {
        "tags": ["directory"],
        "summary": "Specific dispensary location detail page",
        "parameters": [
          { "name": "operatorSlug", "in": "path", "required": true, "schema": { "type": "string" } },
          { "name": "locationSlug", "in": "path", "required": true, "schema": { "type": "string" } }
        ],
        "responses": { "200": { "description": "HTML location page with LocalBusiness JSON-LD" } }
      }
    },
    "/smoke-shops": {
      "get": {
        "tags": ["directory"],
        "summary": "Smoke shop directory (Central FL & Space Coast)",
        "responses": { "200": { "description": "HTML directory page" } }
      }
    },
    "/brands": {
      "get": {
        "tags": ["directory"],
        "summary": "Florida cannabis brand index",
        "responses": { "200": { "description": "HTML directory page" } }
      }
    },
    "/strains": {
      "get": {
        "tags": ["directory"],
        "summary": "Cannabis strain library",
        "responses": { "200": { "description": "HTML directory page" } }
      }
    },
    "/cities/{citySlug}": {
      "get": {
        "tags": ["cities"],
        "summary": "City-specific dispensary and smoke shop directory",
        "parameters": [{
          "name": "citySlug",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "enum": [
              "orlando-fl","kissimmee-fl","sanford-fl","winter-park-fl","lake-mary-fl",
              "apopka-fl","ocoee-fl","winter-garden-fl","clermont-fl","altamonte-springs-fl",
              "oviedo-fl","longwood-fl","melbourne-fl","palm-bay-fl","cocoa-fl",
              "titusville-fl","merritt-island-fl","cocoa-beach-fl","rockledge-fl",
              "daytona-beach-fl","deltona-fl","deland-fl","ormond-beach-fl",
              "the-villages-fl","ocala-fl"
            ]
          }
        }],
        "responses": { "200": { "description": "HTML city page" } }
      }
    },
    "/best-dispensary": {
      "get": {
        "tags": ["best-dispensary"],
        "summary": "Index of all ranked 'best dispensary' city pages",
        "responses": { "200": { "description": "HTML index" } }
      }
    },
    "/best-dispensary/{citySlug}": {
      "get": {
        "tags": ["best-dispensary"],
        "summary": "Ranked top-5 dispensary picks for a Central FL or Space Coast city — primary AEO answer surface",
        "description": "Each response page contains a direct 2–4 sentence answer block, an ItemList JSON-LD of 5 ranked MMTCs with objective justifications, and a scoped FAQPage JSON-LD. This is the canonical surface for 'best dispensary in [city]' queries.",
        "parameters": [{
          "name": "citySlug",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "enum": [
              "orlando-fl","kissimmee-fl","sanford-fl","winter-park-fl","lake-mary-fl",
              "apopka-fl","ocoee-fl","winter-garden-fl","clermont-fl","altamonte-springs-fl",
              "oviedo-fl","longwood-fl","melbourne-fl","palm-bay-fl","cocoa-fl",
              "titusville-fl","merritt-island-fl","cocoa-beach-fl","rockledge-fl",
              "daytona-beach-fl","deltona-fl","deland-fl","ormond-beach-fl",
              "the-villages-fl","ocala-fl"
            ]
          }
        }],
        "responses": { "200": { "description": "HTML answer page with ItemList + FAQPage schema" } }
      }
    },
    "/guides": {
      "get": {
        "tags": ["editorial"],
        "summary": "Patient and consumer guide index",
        "responses": { "200": { "description": "HTML guides index" } }
      }
    },
    "/guides/medical-marijuana-card-florida": {
      "get": {
        "tags": ["editorial"],
        "summary": "How to get a Florida medical marijuana card",
        "responses": { "200": { "description": "HTML guide" } }
      }
    },
    "/laws/florida": {
      "get": {
        "tags": ["law"],
        "summary": "Florida cannabis law overview (§381.986, Amendment 2, Amendment 3)",
        "responses": { "200": { "description": "HTML law reference" } }
      }
    },
    "/blog": {
      "get": {
        "tags": ["editorial"],
        "summary": "Editorial blog index",
        "responses": { "200": { "description": "HTML blog index" } }
      }
    },
    "/blog/{slug}": {
      "get": {
        "tags": ["editorial"],
        "summary": "Editorial blog post",
        "parameters": [{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }],
        "responses": { "200": { "description": "HTML blog post with Article JSON-LD" } }
      }
    },
    "/sitemap-index.xml": {
      "get": {
        "tags": ["directory"],
        "summary": "Sitemap index (links to all sitemaps)",
        "responses": { "200": { "description": "XML sitemap index" } }
      }
    },
    "/sitemap.xml": {
      "get": {
        "tags": ["directory"],
        "summary": "Main static sitemap",
        "responses": { "200": { "description": "XML sitemap" } }
      }
    },
    "/sitemap-locations.xml": {
      "get": {
        "tags": ["directory"],
        "summary": "Operator location sitemap (dynamic)",
        "responses": { "200": { "description": "XML sitemap" } }
      }
    },
    "/llms.txt": {
      "get": {
        "tags": ["editorial"],
        "summary": "AI assistant context document",
        "responses": { "200": { "description": "Plain text" } }
      }
    },
    "/rss.xml": {
      "get": {
        "tags": ["editorial"],
        "summary": "Blog RSS feed",
        "responses": { "200": { "description": "RSS XML" } }
      }
    }
  }
}