Ir al contenido

Errores

Formato de las respuestas de error y significado de cada código.

En un error, data es null y error trae un código estable y un mensaje:

{
"data": null,
"status": 401,
"error": { "code": "UNAUTHORIZED", "message": "API key inválida" }
}

Usa error.code: el mensaje puede cambiar.

Estado error.code Qué significa Qué hacer
400 VALIDATION_ERROR Parámetro no válido (limit fuera de rango, id no UUID). Corrige el parámetro.
401 UNAUTHORIZED Clave ausente, inválida, revocada, vencida o de un usuario inactivo. Revisa la cabecera o crea otra clave.
403 FORBIDDEN Falta el alcance, o el recurso está fuera de sus proyectos. Usa una clave con ese permiso.
404 NOT_FOUND No existe o no puedes verlo. Revisa el id y tus permisos.
429 RATE_LIMITED Más de 60 solicitudes por minuto. Espera Retry-After segundos.