{
  "openapi": "3.1.0",
  "info": {
    "title": "JP Solutions Agentic & Business API",
    "description": "API pública y descriptiva de servicios, automatizaciones y agentes de JP Solutions.",
    "version": "1.0.0",
    "contact": {
      "name": "JP Solutions Support",
      "url": "https://www.jpsolutions.online/#contacto",
      "email": "contacto@jpsolutions.online"
    }
  },
  "servers": [
    {
      "url": "https://www.jpsolutions.online",
      "description": "Servidor de Producción JP Solutions"
    }
  ],
  "paths": {
    "/api/services": {
      "get": {
        "summary": "Obtener catálogo de servicios de IA y automatización",
        "operationId": "getServices",
        "description": "Retorna la lista completa de soluciones disponibles: automatización de flujos, agentes de voz y desarrollo de IA a medida.",
        "responses": {
          "200": {
            "description": "Lista de servicios de JP Solutions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": { "type": "string" },
                      "title": { "type": "string" },
                      "description": { "type": "string" },
                      "category": { "type": "string" }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/contact": {
      "post": {
        "summary": "Enviar solicitud de contacto, consultoría o presupuesto",
        "operationId": "submitContactInquiry",
        "description": "Permite a usuarios o agentes de IA enviar una propuesta de proyecto o requerimiento de automatización.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["nombre", "correo", "descripcion"],
                "properties": {
                  "nombre": { "type": "string", "description": "Nombre de contacto o representante" },
                  "correo": { "type": "string", "format": "email", "description": "Correo corporativo" },
                  "empresa": { "type": "string", "description": "Nombre de la empresa" },
                  "descripcion": { "type": "string", "description": "Detalle del proyecto o proceso a automatizar" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Solicitud recibida exitosamente",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean" },
                    "message": { "type": "string" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "summary": "Estado del servicio",
        "operationId": "getHealthStatus",
        "responses": {
          "200": {
            "description": "Servicio operando normalmente",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": { "type": "string", "example": "ok" },
                    "timestamp": { "type": "string", "format": "date-time" }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
