# Validador de OpenAPI / Swagger Valida estructuralmente documentos OpenAPI 3.0/3.1 y Swagger 2.0: campos requeridos, integridad de rutas/operaciones, códigos de respuesta, resolución de $ref, unicidad de operationId e integridad de componentes > Página canónica: https://elysiatools.com/es/tools/openapi-validator - **Categoría:** Validation - **Palabras clave:** openapi, swagger, validar, api, spec, rest ## Descripción general El Validador de OpenAPI / Swagger es una herramienta diseñada para verificar la estructura y la integridad de tus especificaciones de API en formatos OpenAPI 3.0/3.1 y Swagger 2.0. Permite detectar de forma inmediata errores en campos requeridos, referencias $ref rotas, duplicados en operationId, códigos de respuesta incorrectos y problemas de consistencia en los componentes de tu API REST. ## Entradas - **Documento OpenAPI / Swagger** (textarea): openapi: 3.0.3 info: title: Example API version: 1.0.0 paths: /users: get: summary: List users responses: '200': description: OK ## Cuándo usarlo - Antes de publicar la documentación de una API REST para asegurar que cumple estrictamente con el estándar OpenAPI o Swagger. - Al depurar errores de referencias internas ($ref) o identificadores de operación (operationId) duplicados en archivos de especificación complejos. - Durante el diseño de contratos de API para validar que los cambios en las rutas y esquemas no rompan la estructura esperada. ## Cómo funciona - Pega el contenido de tu documento OpenAPI (3.0/3.1) o Swagger (2.0) en formato YAML o JSON en el campo de texto de la herramienta. - El validador analiza la estructura del documento, verificando la sintaxis, los campos obligatorios y la resolución de referencias. - Revisa el informe detallado en pantalla con los errores de validación, advertencias de integridad y sugerencias de corrección. ## Casos de uso - Validación rápida de esquemas JSON/YAML de API REST antes de generar clientes SDK automáticos. - Detección de inconsistencias en códigos de respuesta HTTP y parámetros obligatorios faltantes en las rutas. - Auditoría de la sección de componentes para asegurar que todos los esquemas definidos estén correctamente estructurados. ## Preguntas frecuentes ### ¿Qué versiones de OpenAPI y Swagger soporta este validador? Soporta las especificaciones OpenAPI 3.0, OpenAPI 3.1 y Swagger 2.0. ### ¿Cómo detecta la herramienta las referencias rotas? Analiza todos los punteros $ref en el documento y verifica que apunten a componentes existentes y válidos dentro del esquema. ### ¿Es necesario que el documento esté en formato JSON o YAML? No, la herramienta acepta y procesa ambos formatos de serialización de manera automática. ### ¿Por qué es importante tener un operationId único? Los generadores de código y herramientas de documentación utilizan el operationId para nombrar métodos; los duplicados causan colisiones y errores de compilación. ### ¿El validador almacena el contenido de mi especificación de API? No, la validación se realiza de forma local y segura en tu navegador sin almacenar tus datos. ## Herramientas relacionadas - [Validador de Códigos Postales Globales](https://elysiatools.com/es/tools/global-postal-code-validator): Valida formatos de códigos postales de múltiples países, incluyendo EE.UU. ZIP, Reino Unido, Canadá y más - [IBAN & SWIFT Validator](https://elysiatools.com/es/tools/iban-swift-validator): Validate International Bank Account Number (IBAN) and SWIFT/BIC codes with checksum verification - [Calculadora de suma de comprobación Mod-11](https://elysiatools.com/es/tools/mod11-checksum): Valida o genera números con el algoritmo de dígito de control Módulo 11 (ISO 7064) con esquemas de peso ISBN-10 (10..2), ID noruega (3,7,6,1,8,9,4,5,2) y genérico 2-7. - [Validador de Códigos Postales de EE.UU.](https://elysiatools.com/es/tools/us-zip-code-validator): Valida códigos postales de Estados Unidos, incluyendo formatos estándar de 5 dígitos y ZIP+4 - [Validador de Moneda](https://elysiatools.com/es/tools/currency-validator): Valida códigos de moneda ISO 4217 - [Validador de Email](https://elysiatools.com/es/tools/email-validator): Valida direcciones de correo electrónico y verifica la entregabilidad - [Validador de Archivos .env](https://elysiatools.com/es/tools/env-file-validator): Validar archivos .env para errores de sintaxis y problemas comunes - [Validador Global de Números de Teléfono](https://elysiatools.com/es/tools/global-phone-validator): Valida números de teléfono de múltiples países incluyendo China, EE.UU. y más con información detallada ## Ejemplos - [Ejemplos OpenAPI/Swagger](https://elysiatools.com/es/samples/openapi): Ejemplos de especificación OpenAPI/Swagger para documentación y definición de contratos de API REST - [Ejemplos OpenAPI/Swagger](https://elysiatools.com/es/samples/openapi-swagger): Ejemplos completos de documentación API usando OpenAPI 3.0 y especificaciones Swagger para servicios RESTful - [Ejemplos de Procesamiento de Imágenes Android Java](https://elysiatools.com/es/samples/android-image-processing-java): Ejemplos de procesamiento de imágenes Android Java incluyendo lectura/escritura, escalado y conversión de formato - [Ejemplos de Procesamiento de Imágenes Android Kotlin](https://elysiatools.com/es/samples/android-image-processing-kotlin): Ejemplos de procesamiento de imágenes Android Kotlin incluyendo lectura/escritura, escalado y conversión de formato ## Contenido relacionado - [Versionado de API y revision de cambios incompatibles](https://elysiatools.com/es/hubs/api-versioning-breaking-change-review): Compara versiones de API, planifica la migracion y acepta la compatibilidad antes del lanzamiento. Las herramientas no sustituyen el despliegue real ni la monitorizacion.