Petición incorrecta
La API devuelve "title": "BAD_REQUEST"
Un error en la petición. Hay algo que cambiar antes de volver a mandarla.
La petición no llegó a procesarse porque algo en ella no tiene la forma esperada. No es un problema de permisos ni de estado: es la forma de lo que mandaste.
Qué mirar primero
Si el code es VALIDATION_ERROR, la respuesta trae un array errors que dice exactamente qué
campo falló:
{ "type": "https://docs.slan.mx/problems/400", "title": "BAD_REQUEST", "status": 400, "code": "VALIDATION_ERROR", "errors": ["email debe ser un correo electrónico válido"], "detail": "Falló la validación del cuerpo."}La causa que más cuesta encontrar
Un campo de más también es un 400. La API rechaza cualquier propiedad que no esté en el contrato, en vez de ignorarla en silencio. Si añadiste un campo «por si acaso», quítalo.
Es deliberado: aceptar un campo desconocido haría creer que se guardó algo que en realidad se descartó.
Reintentar
No. Un 400 es determinista: la misma petición va a fallar igual. Corrige el cuerpo antes de
volver a mandarla.
Códigos que aparecen con este estado
Programa contra el campo code, nunca contra detail: la redacción puede cambiar, el código no.
code | Qué significa |
|---|---|
VALIDATION_ERROR | Un campo del cuerpo o de la consulta no tiene la forma esperada |
IDEMPOTENCY_KEY_REQUIRED | Falta la cabecera Idempotency-Key en un POST que la exige |
CURSOR_INVALID | El cursor de paginación está malformado |
Llegaste aquí desde el campo type de una respuesta de error. La guíaErrores explica el formato completo y qué hacer con cada campo.