Validación de esquema en la entrada y en la salida

Validar con un esquema es un modelo positivo: en lugar de buscar lo malo, se describe lo único que es aceptable y se rechaza todo lo demás. Un esquema bien escrito fija el tipo de cada propiedad, sus longitudes, sus rangos, la lista cerrada de valores cuando la hay, cuáles son obligatorias y, con additionalProperties: false, que no se acepte ninguna propiedad que no esté declarada. Desde la versión 3.1, los esquemas de OpenAPI son JSON Schema, y en JSON Schema lo que no se prohíbe se permite: un objeto sin esa palabra acepta cualquier propiedad extra.

La validación de entrada no reemplaza la codificación por contexto ni la autorización: un texto puede tener la longitud correcta y aun así terminar en una consulta mal construida. Lo que sí hace es reducir mucho lo que llega al código y cortar de raíz las propiedades que nadie esperaba.

Abre el laboratorio y lee domicilios-v1.yaml. Compara cómo están acotadas las propiedades de texto de la solicitud con las de la dirección. Hay una que no tiene ni longitud máxima, ni patrón, ni lista de valores, y el registro de validación muestra lo que llegó por ella.

validacion.yaml dice que la pasarela rechaza propiedades no declaradas solo si el esquema lo pide. El esquema de la dirección lo pide; el de la solicitud no. Lee registro-validacion.txt: el validador anota en cada entrada las propiedades no declaradas que encontró.

La validación de salida compara la respuesta del servicio con su esquema antes de entregarla. Configurada para bloquear, impide que salga un campo que nadie declaró; configurada para registrar, solo deja constancia mientras el dato llega al cliente. Lee qué modo eligió Tasajera y qué anotó el validador en las respuestas.

Las propiedades que se colaron en la entrada no son inocentes: el costo del envío y la prioridad los decide Tasajera, no el cliente, así que si el servicio llegara a leerlas sería una asignación masiva. Y el teléfono personal del repartidor sale hacia cualquier cliente que consulte su domicilio. La corrección vive en dos sitios: el contrato y la configuración del validador.