Quickmock

Simular un error problem+json de RFC 9457

Un mock GET que devuelve un error de validación 422 en application/problem+json según lo determinado en el RFC 9457.

El RFC 9457 define application/problem+json, una forma estándar para los cuerpos de error HTTP con type, title, status y detail. Esta plantilla devuelve un documento de problema 422 con una extensión errors a nivel de campo, de modo que puedas construir y probar el manejo de errores contra el formato y no contra el JSON improvisado que tu backend emita hoy.

Sustituye a un endpoint de API de terceros.

Payload de respuesta

{"type":"https://quickmock.dev/problems/validation-error","title":"Your request parameters didn't validate","status":422,"detail":"The 'email' field must be a valid email address.","instance":"{{mock.url}}/requests/38f0","errors":[{"field":"email","message":"must be a valid email address"}]}

Campos que vale la pena conocer

Campo Lo que significa
type Una URI del tipo de error para documentar qué es lo que falló.
title Un corto resumen del problema comprensible para humanos.
status Refleja el estado y código de respuesta HTTP, guardado a mayores para que el cliente lo tenga o lo registre en el log.
detail Una explicación pormenorizada de lo sucedido; edita para probar cómo lo trata tu cliente en el parseo.
errors Un array u objeto (no estándar de base) extra para la extensión con errores a nivel de campo tal y como se hace en las API del estilo Stripe y demás.

Crear el mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "GET",
  "response_status": 422,
  "content_type": "application/problem+json",
  "response_body": "{\"type\":\"https://quickmock.dev/problems/validation-error\",\"title\":\"Your request parameters didn't validate\",\"status\":422,\"detail\":\"The 'email' field must be a valid email address.\",\"instance\":\"{{mock.url}}/requests/38f0\",\"errors\":[{\"field\":\"email\",\"message\":\"must be a valid email address\"}]}"
}'

Llamarlo

curl https://quickmock.dev/m/<slug>

Lo que obtienes

GET /m/<slug> -> 422 application/problem+json
an RFC 9457 problem document with a custom errors[] extension

En qué se diferencia de la realidad

Este es un error de validación fijo: estado, detalle y la extensión errors[] están todos codificados, edita la respuesta para lo que tu cliente realmente necesita manejar.

Fuentes

Preguntas frecuentes

¿Qué es problem+json y por qué usarlo?
Es un estándar RFC 9457 para evitar que cada API tenga y construya su propio sistema de validación y de respuesta a errores.
¿Por qué el estado aparece tanto en el cuerpo como en la respuesta de HTTP?
El status de cuerpo es un reflejo de HTTP status para que pueda mantener el mismo contexto aun cuando sea parseado y documentado aparte.
¿Es el arreglo errors parte del estándar?
No, es un miembro extra de la extensión de GitHub o Stripe. Tu cliente deberá interpretar el modelo común pero extender las clases según correspondan.

¿Listo para usarlo?

Ábrelo en el generador de mocks para ajustarlo primero

Combina bien con esta guía: Simular una respuesta de error específica

Plantillas relacionadas

← Todas las plantillas

Última actualización: 2026-10-17