{
  "openapi": "3.0.3",
  "info": {
    "title": "Tenerife South Travel Companion API",
    "description": "Public API catalog and content management services for Tenerife South destinations, beaches, natural pools, local eats, cultural events, and practical travel information.",
    "version": "1.0.0",
    "contact": {
      "name": "Tenerife South Guide Team",
      "url": "https://discovertenerifesouth.com"
    }
  },
  "servers": [
    {
      "url": "https://discovertenerifesouth.com/api/v1",
      "description": "Production API Server"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "summary": "Health Check Endpoint",
        "description": "Returns operational status and uptime of the API services.",
        "responses": {
          "200": {
            "description": "Service is healthy and operational.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": { "type": "string", "example": "ok" },
                    "timestamp": { "type": "string", "example": "2026-11-07T21:30:00.000Z" },
                    "service": { "type": "string", "example": "Tenerife South API" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/content": {
      "get": {
        "summary": "List Articles and Guide Items",
        "description": "Retrieve destinations, beaches, natural pools, activities, local eats, cultural agenda, transport routes, and practical travel information.",
        "parameters": [
          {
            "name": "section",
            "in": "query",
            "required": false,
            "schema": { "type": "string" },
            "description": "Filter by section type (e.g. destinations, beaches, naturalPools, activities, localEats, party, agenda, transport, practical)"
          }
        ],
        "responses": {
          "200": {
            "description": "List of travel guide items.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": { "type": "string" },
                      "name": { "type": "string" },
                      "description": { "type": "string font" },
                      "category": { "type": "string" }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}