# Validador de contrato de respuesta API Valida un JSON de respuesta real contra el schema de respuesta declarado en OpenAPI 3.x > Página canónica: https://elysiatools.com/es/tools/api-response-contract-validator - **Categoría:** Development - **Palabras clave:** openapi, api, respuesta, schema, contrato ## Descripción general Pega un documento OpenAPI 3.x y una respuesta real, luego indica path, method y status code. La herramienta resuelve el schema de respuesta y destaca campos faltantes, tipos incorrectos, enums invalidos y campos no documentados. Como usar: - Spec OpenAPI: pega YAML o JSON - JSON de respuesta: pega la carga real - Ruta / Metodo / Codigo de estado: identifica la operacion y respuesta - Formato del spec: usa auto si no estas seguro - Prohibir campos extra: avisa cuando aparezcan campos no descritos ## Entradas - **Spec OpenAPI** (textarea): openapi: 3.0.3 paths: /users/{id}: ... - **JSON de respuesta** (textarea): {"id":1,"name":"Alice"} - **Ruta** (text): /users/123 - **Metodo** (select) - **Codigo de estado** (text): 200 - **Formato del spec** (select) - **Prohibir campos extra** (checkbox) ## Cuándo usarlo - Durante el desarrollo y pruebas de APIs para asegurar que el backend devuelve exactamente lo que promete la documentación oficial. - Al depurar problemas de integración entre el frontend y el backend causados por cambios inesperados en la estructura de los datos. - Para auditar respuestas de producción y garantizar el cumplimiento estricto del contrato OpenAPI antes de un lanzamiento. ## Cómo funciona - Pega tu especificación OpenAPI 3.x (en formato YAML o JSON) y el JSON de la respuesta real que deseas validar. - Define la ruta (path), el método HTTP (GET, POST, etc.) y el código de estado (ej. 200) para localizar el esquema exacto en tu documento. - Opcionalmente, activa la opción de prohibir campos extra para detectar propiedades que no estén declaradas en el contrato. - La herramienta analiza los datos y genera un reporte detallado destacando campos faltantes, tipos de datos incorrectos o valores inválidos. ## Casos de uso - Validación de contratos impulsada por el consumidor (Consumer-Driven Contract Testing) para evitar rupturas en clientes móviles o web. - Revisión rápida de endpoints problemáticos donde se sospecha que el backend está enviando tipos de datos incorrectos (ej. un string en lugar de un entero). - Auditoría de APIs heredadas para descubrir campos no documentados que se están filtrando en las respuestas de producción. ## Preguntas frecuentes ### ¿Qué versiones de OpenAPI soporta esta herramienta? Actualmente soporta especificaciones basadas en el estándar OpenAPI 3.x. ### ¿Qué significa la opción de prohibir campos extra? Al activarla, la herramienta generará advertencias si el JSON de respuesta contiene propiedades que no están descritas explícitamente en el esquema de la especificación. ### ¿Es necesario indicar si mi especificación es YAML o JSON? No, puedes dejar la opción de formato en 'Auto' y el validador detectará automáticamente si el texto introducido es YAML o JSON. ### ¿Cómo sabe la herramienta qué esquema validar? Utiliza la combinación de la ruta (path), el método HTTP y el código de estado que ingreses para localizar la respuesta exacta dentro de tu documento OpenAPI. ### ¿Puedo validar respuestas que no sean JSON? No, esta herramienta está diseñada exclusivamente para validar cargas útiles (payloads) de respuesta en formato JSON. ## Herramientas relacionadas - [Generador de JSON Schema](https://elysiatools.com/es/tools/json-schema-generator): Infiere JSON Schema desde JSON de ejemplo, permite ajustes manuales y validacion - [Puente de PDF (OCR) a JSON estructurado](https://elysiatools.com/es/tools/ocr-pdf-to-structured-json-bridge): Extrae la capa de texto del PDF con geometría (líneas por posición y, tablas por huecos de columna, títulos por tamaño de fuente, pares clave-valor con dos puntos) y rellena campo a campo un JSON Schema del usuario — etiquetas emparejadas por claves normalizadas, valores coaccionados a los tipos declarados y validados con ajv. - [Constructor integral de enlace corto + UTM + QR](https://elysiatools.com/es/tools/short-url-utm-builder-qr-bundle): Una sola pasada sustituye al trío bit.ly + Campaign Builder + generador de QR: introduces la URL de destino y los parámetros UTM (trío obligatorio de GA4 validado, normalización a minúsculas opcional) y obtienes la URL completa con seguimiento; un slug base62 determinista (hash FNV-1a, misma entrada → mismo slug, sin cuentas ni red) sobre tu dominio corto; dos códigos QR en PNG (enlace corto y completo); y listos los ajustes de redirección nginx / vercel.json / Netlify y la fila CSV de seguimiento de campañas. - [Divisor train/test con estratificación](https://elysiatools.com/es/tools/train-test-split-with-stratification): Lee un dataset CSV/JSON y divide en train/validation/test con muestreo estratificado por la columna objetivo (70/15/15 por defecto, semilla reproducible), o valida con k-fold estratificado; incluye informe de distribución de clases por split con barras de desviación, comprobación de fugas por filas duplicadas, vista previa de SMOTE (interpolación de vecinos sobre el split de train) y exportación de los CSV en ZIP. - [Validador de JSON Schema](https://elysiatools.com/es/tools/json-schema-validator): Valida datos JSON contra un JSON Schema para verificar estructura y tipos de datos - [REPL de JSONPath interactivo](https://elysiatools.com/es/tools/jsonpath-repl-playground): Un REPL interactivo de JSONPath que ejecuta pipelines de consulta de varios pasos sobre cualquier JSON. Escribe una expresión JSONPath por línea (p. ej. $..book\[?(@.price<10)\] luego $\[0:5\]) y verás los matches de cada paso con conteos, rutas y valores — más una URL compartible que codifica tus datos y pipeline. Soporta descenso recursivo ($..), comodines (\[*\]), filtros (\[?(@.price<10)\]), slices (\[0:5:2\]) e índices negativos. - [OpenAPI a Postman Collection](https://elysiatools.com/es/tools/openapi-to-postman-collection): Convierte una spec OpenAPI 3.x o Swagger 2.0 (JSON/YAML) en una Postman Collection v2.1.0 importable con carpetas, variables, auth y respuestas de ejemplo. - [Generador de OpenAPI a TypeScript](https://elysiatools.com/es/tools/openapi-to-typescript-generator): Convierte especificaciones OpenAPI o Swagger en JSON/YAML a tipos TypeScript, parametros de solicitud y modelos de respuesta con formato y nombres configurables ## Ejemplos - [Colecciones Postman - Pruebas API](https://elysiatools.com/es/samples/postman-collections): Ejemplos completos de colecciones Postman incluyendo pruebas de API, scripts de automatización, variables de entorno, servidores mock y patrones avanzados de prueba para REST APIs - [Ejemplos de AWS EventBridge](https://elysiatools.com/es/samples/eventbridge-samples): Ejemplos de AWS EventBridge incluyendo buses de eventos, reglas, objetivos, registro de esquemas, eventos personalizados y enrutamiento de eventos entre cuentas para arquitectura serverless event-driven - [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 - [Muestras de Trazado Distribuido](https://elysiatools.com/es/samples/distributed-tracing-samples): Ejemplos completos de trazado distribuido usando Jaeger, OpenTelemetry y herramientas de observabilidad modernas ## Contenido relacionado - [Definición de contratos API, validación de esquemas y pruebas de cambios](https://elysiatools.com/es/hubs/api-contract-testing): Define un contrato API, valida esquemas y cargas capturadas, detecta riesgos de compatibilidad y registra la aceptación. - [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. - [Herramientas de utilidad, inspeccion y transformacion JSON](https://elysiatools.com/es/hubs/json-utility): Formatea, inspecciona, compara, combina, transforma, valida, analiza y marca JSON para flujos de API y datos. - [Herramientas de validación de JSON Schema y contratos API](https://elysiatools.com/es/hubs/json-validate): Compara validación de JSON Schema, comprobaciones de respuesta OpenAPI, mutation testing, stress testing y detección de cambios incompatibles en un solo hub para revisión de contratos API.