Saltar al contenido
Docs

Respuestas de error

422

Regla de negocio incumplida

La API devuelve "title": "UNPROCESSABLE_ENTITY"

Un error en la petición. Hay algo que cambiar antes de volver a mandarla.

Los datos que mandaste tienen la forma correcta, pero violan una regla de negocio.

Esa es la diferencia con un 400: allí el problema es la forma —un campo que no es un correo, un número donde va texto—; aquí la forma es impecable y lo que falla es el significado.

El caso que no lleva code propio

Reutilizar una Idempotency-Key con un cuerpo distinto también responde 422.

Es una protección: significa que por error usaste para una operación la clave de otra. Si lo permitiéramos, una de las dos intenciones se perdería en silencio. Lee Idempotencia.

Reintentar

No sin cambiar el cuerpo. La regla que incumpliste no va a cambiar entre un intento y el siguiente.

Lee code y detail para saber cuál es: detail explica el límite concreto que se superó.

Códigos que aparecen con este estado

Programa contra el campo code, nunca contra detail: la redacción puede cambiar, el código no.

codeQué significa
LINK_EXPIRY_TOO_LONGexpiresInHours supera el máximo de 720 horas
LINK_USES_INVALIDmaxUses está fuera del rango permitido

Llegaste aquí desde el campo type de una respuesta de error. La guíaErrores explica el formato completo y qué hacer con cada campo.