JSON Schema Validation

El objetivo del interceptor JSON Schema Validation es comprobar si el contenido del cuerpo de una petición o respuesta a alguna API está siguiendo las reglas establecidas de un JSON schema definido en el interceptor durante su configuración.

Para configurar el interceptor, acceder a la página Flows de una API, a la pestaña Traffic y arrastrar el interceptor JSON Schema Validation al flujo deseado (request o response).

Después de definir dónde se ejecutará el interceptor, se abrirá una nueva pantalla para la descripción del JSON schema que validará el contenido JSON transmitido en la llamada, como se muestra a continuación:

El JSON schema anterior valida un objeto simple que contiene los atributos FirstName, LastName y age, con los dos primeros atributos establecidos como obligatorios (a través del atributo required) y el límite de edad (age) descrito por el atributo minimum.

Después de establecer las definiciones de su archivo JSON schema, haga clic en el botón Save para registrar los cambios y continuar con los procedimientos habituales de creación de API (haciendo clic en el botón Continue en la pantalla Flows). Cuando se realiza una llamada a la API, el interceptor estará disponible para ejecutar validaciones.

El siguiente ejemplo representa una llamada a una API utilizando el interceptor JSON Schema Validation mostrado en la imagen anterior.

Tenga en cuenta que, durante la llamada, simulamos la falta del atributo lastName en el cuerpo de la petición. Por consiguiente, la respuesta de validación para el JSON schema utilizado siempre será el HTTP Status 417, seguido de un objeto que contiene el resultado de todo el proceso, como se muestra a continuación.