{
  "openapi": "3.1.0",
  "info": {
    "title": "API pública de Clínicas Veterinarias VetSur",
    "version": "1.0.0",
    "summary": "Sedes, horarios, servicios y urgencias de VetSur (Fuengirola y Torremolinos, Málaga).",
    "description": "API de sólo lectura, sin autenticación, pensada para agentes de IA y asistentes.\n\nLos horarios se evalúan en la zona horaria Europe/Madrid y no contemplan festivos locales. La información clínica es orientativa y no sustituye el criterio de un veterinario colegiado.",
    "contact": {
      "name": "Clínicas Veterinarias VetSur",
      "email": "info@clinicaveterinariavetsur.com",
      "url": "https://www.clinicaveterinariavetsur.com/"
    },
    "license": {
      "name": "CC BY 4.0",
      "identifier": "CC-BY-4.0"
    }
  },
  "servers": [
    {
      "url": "https://www.clinicaveterinariavetsur.com",
      "description": "Producción"
    }
  ],
  "paths": {
    "/api/v1/clinicas": {
      "get": {
        "operationId": "listarClinicas",
        "summary": "Lista todas las sedes de VetSur",
        "responses": {
          "200": {
            "description": "Listado de sedes",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/api/v1/clinicas/{id}": {
      "get": {
        "operationId": "obtenerClinica",
        "summary": "Datos de una sede concreta",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "fuengirola",
                "torremolinos"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Datos de la sede"
          },
          "404": {
            "description": "Sede no encontrada"
          }
        }
      }
    },
    "/api/v1/clinicas/{id}/horarios": {
      "get": {
        "operationId": "obtenerHorarios",
        "summary": "Horario semanal y si la sede está abierta ahora",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "fuengirola",
                "torremolinos"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Horario y estado de apertura"
          },
          "404": {
            "description": "Sede no encontrada"
          }
        }
      }
    },
    "/api/v1/servicios": {
      "get": {
        "operationId": "listarServicios",
        "summary": "Servicios veterinarios ofrecidos",
        "parameters": [
          {
            "name": "clinica",
            "in": "query",
            "required": false,
            "description": "Filtra por sede",
            "schema": {
              "type": "string",
              "enum": [
                "fuengirola",
                "torremolinos"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Listado de servicios"
          }
        }
      }
    },
    "/api/v1/servicios/{id}": {
      "get": {
        "operationId": "obtenerServicio",
        "summary": "Detalle de un servicio",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "cirugia-general",
                "traumatologia",
                "medicina-interna",
                "medicina-preventiva",
                "diagnostico-por-imagen",
                "urgencias"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Detalle"
          },
          "404": {
            "description": "No encontrado"
          }
        }
      }
    },
    "/api/v1/urgencias": {
      "get": {
        "operationId": "obtenerUrgencias",
        "summary": "Sedes con servicio de urgencias y cómo contactarlas",
        "responses": {
          "200": {
            "description": "Información de urgencias"
          }
        }
      }
    },
    "/api/v1/buscar": {
      "get": {
        "operationId": "buscarPorLocalidad",
        "summary": "Sede que atiende una localidad de la Costa del Sol",
        "parameters": [
          {
            "name": "localidad",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Mijas"
          }
        ],
        "responses": {
          "200": {
            "description": "Sedes que cubren la localidad"
          },
          "400": {
            "description": "Falta el parámetro"
          }
        }
      }
    },
    "/api/v1/health": {
      "get": {
        "operationId": "health",
        "summary": "Estado del servicio",
        "responses": {
          "200": {
            "description": "Servicio operativo"
          }
        }
      }
    }
  }
}