Manejo de errores
Aprende a gestionar los errores de la API de forma adecuada en tu aplicación.
Cuando se produce un error en una solicitud a la API, AllNewsAPI devuelve una respuesta de error en formato JSON con un código de estado y un encabezado estandarizado. El cuerpo de la respuesta siempre contiene un objeto de detalles con un campo de mensaje que describe el problema. Esta guía explica cada error y cómo gestionarlo.
Formato de respuesta de error
Todas las respuestas de error de la API (4xx y 5xx) utilizan un formato JSON consistente. El campo detail.message siempre contiene una descripción legible del error.
Códigos de error
400 Solicitud incorrecta
Su solicitud está mal formada o le faltan parámetros obligatorios. Revise los parámetros de su consulta e inténtelo de nuevo.
401 No autorizado
Tu clave API no es válida o falta. Verifica que tu clave API sea correcta y esté incluida en la solicitud.
403 Prohibido
Tu cuenta no tiene permiso para esta solicitud. Esto puede ocurrir si intentas acceder a funciones premium con un plan gratuito.
429 Demasiadas peticiones
Has superado tu límite diario de solicitudes. Espera a que el límite se restablezca a las 00:00 UTC o actualiza tu plan.
503 Servicio no disponible
La API no está disponible temporalmente por mantenimiento. Inténtelo de nuevo en unos minutos.
Ejemplo:
Buenas prácticas para el manejo de errores
- Siempre verifique el código de estado de respuesta antes de procesar los datos.
- Implementar retroceso exponencial para reintentar las solicitudes fallidas
- Extraiga el mensaje de error de response.detail.message para una visualización de errores más amigable para el usuario.