Updated on 22 sept 2023

Lectura de

3

min

Manejo de errores

Cuando se interactúa con la API de películas es importante entender cómo se manejan los errores y cómo solucionar los problemas que puedan aparecer durante las solicitudes a la API. Este documento cubre los diversos aspectos del manejo de errores dentro de la API.

Formato de respuesta de error

La API de películas utiliza JSON para las respuestas de error. Cuando ocurre un error, la API responde con un objeto JSON que contiene los siguientes campos:

  • estado: El código de estado HTTP que indica el tipo de error.

  • mensaje: Un mensaje de error legible para el ser humano que describe el problema.

  • detalles (opcional): Detalles adicionales sobre el error, si están disponibles.

A continuación se muestra un ejemplo de respuesta de error:

{
  "status": 404,
  "message": "Resource not found",
  "details": "The requested movie does not exist."
}

Códigos de estado HTTP comunes

La API de películas utiliza códigos de estado HTTP estándar para indicar el resultado de una solicitud. Aquí hay algunos de los códigos de estado comunes que puede encontrar:

  • 200 OK: La solicitud se realizó con éxito y la respuesta de la API contiene los datos solicitados.

  • 201 Created: El recurso se creó correctamente (por ejemplo, durante una solicitud POST).

  • 204 No Content: La solicitud se realizó con éxito, pero no hay cuerpo de respuesta (por ejemplo, durante una solicitud DELETE).

  • 400 Bad Request: La solicitud está mal formada o es inválida. Compruebe los parámetros de la solicitud.

  • 401 Unauthorized: Se requiere autenticación o las credenciales proporcionadas no son válidas.

  • 403 Forbidden: La solicitud se entiende pero no está permitida. El usuario puede carecer de los permisos necesarios.

  • 404 Not Found: El recurso solicitado no existe.

  • 405 Method Not Allowed: El método HTTP utilizado no está permitido para el recurso solicitado.

  • 500 Internal Server Error: Ha ocurrido un error inesperado en el servidor. Póngase en contacto con el soporte.

Manejo de errores en el código

Cuando realiza solicitudes a la API en su código, es esencial manejar los errores de manera adecuada. Aquí hay un ejemplo en JavaScript:

fetch(apiUrl)
  .then(response => {
    if (!response.ok) {
      throw new Error(`API Error: ${response.status} - ${response.statusText}`);
    }
    return response.json();
  })
  .then(data => {
    console.log("API Response:", data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

En este ejemplo, verificamos si el estado de la respuesta HTTP indica un error (fuera del rango 200-299) y lanzamos un error con detalles si es necesario. Esto le permite manejar los errores de manera estructurada.

Contactar con soporte

Si encuentra problemas persistentes o tiene preguntas sobre mensajes de error específicos, póngase en contacto con nuestro equipo de soporte en support@moviesapi.com para obtener ayuda.

Comprender el manejo de errores y los códigos de estado es esencial para utilizar eficazmente la API de películas y garantizar una experiencia de usuario fluida.