{
  "openapi": "3.1.0",
  "info": {
    "title": "KAIZEN - Soluciones de Movilidad Public API",
    "version": "1.0.0",
    "description": "API pública de Kaizen Automotores para consulta de stock de usados seleccionados, micromovilidad sustentable, peritaje técnico de 130 puntos y datos de sedes en Córdoba, Argentina.",
    "contact": {
      "name": "Kaizen Automotores",
      "email": "ventas@kaizenautomotores.com.ar",
      "url": "https://www.kaizenautomotores.com.ar"
    }
  },
  "servers": [
    {
      "url": "https://www.kaizenautomotores.com.ar",
      "description": "Servidor de Producción"
    }
  ],
  "paths": {
    "/api/public/vehicles": {
      "get": {
        "summary": "Listar vehículos y unidades de movilidad",
        "description": "Retorna el inventario activo de autos usados seleccionados y unidades de micromovilidad eléctrica (disponibles y reservados).",
        "responses": {
          "200": {
            "description": "Lista de vehículos obtenida correctamente",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Vehicle"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/vehicles/{id}": {
      "get": {
        "summary": "Obtener detalle técnico de un vehículo",
        "description": "Retorna la ficha técnica completa de un auto o unidad de movilidad a partir de su ID ofuscado.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID ofuscado del vehículo (e.g. 24e08)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Detalle del vehículo",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Vehicle"
                }
              }
            }
          },
          "404": {
            "description": "Vehículo no encontrado"
          }
        }
      }
    },
    "/api/public/dealership": {
      "get": {
        "summary": "Información institucional y sedes",
        "description": "Retorna datos de la concesionaria, dirección del showroom central (José Podestá 2644) y centro técnico (Acanpes 3332), teléfonos y horarios.",
        "responses": {
          "200": {
            "description": "Información institucional",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Dealership"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/contact": {
      "post": {
        "summary": "Enviar consulta o solicitar contacto comercial",
        "description": "Registra una consulta sobre un vehículo o solicitud de tasación.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["name", "phone"],
                "properties": {
                  "name": { "type": "string" },
                  "phone": { "type": "string" },
                  "email": { "type": "string" },
                  "message": { "type": "string" },
                  "vehicle_id": { "type": "string" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Consulta enviada exitosamente"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Vehicle": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "make": { "type": "string" },
          "model": { "type": "string" },
          "version": { "type": "string" },
          "year": { "type": "integer" },
          "mileage": { "type": "integer" },
          "price_ars": { "type": "number" },
          "price_usd": { "type": "number" },
          "color": { "type": "string" },
          "status": { "type": "string", "enum": ["Disponible", "Reservado", "Vendido"] },
          "transmission": { "type": "string" },
          "fuel_type": { "type": "string" },
          "image_urls": { "type": "array", "items": { "type": "string" } },
          "description": { "type": "string" }
        }
      },
      "Dealership": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "address": { "type": "string" },
          "phone": { "type": "string" },
          "email": { "type": "string" },
          "business_hours": { "type": "string" }
        }
      }
    }
  }
}