Gestión de errores

Las solicitudes realizadas a nuestras API pueden dar como resultado varias respuestas de error. En el siguiente documento se describen los métodos de recuperación y se proporciona una lista de valores de error con una guía del método de recuperación más común.

Respuestas de error

A continuación, figura una respuesta de error común como resultado de una solicitud fallida de API:

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}

message: descripción legible del error.
code: código del error. Más adelante se indican valores comunes y métodos de recuperación habituales.
error_subcode: información adicional sobre el error. Más adelante se indican valores comunes.
error_user_msg: mensaje que se debe mostrar al usuario. El idioma del mensaje se basa en la configuración regional de la solicitud de la API.
error_user_title: título del cuadro de diálogo, en caso de que se muestre. El idioma del mensaje se basa en la configuración regional de la solicitud de la API.
fbtrace_id: identificador de asistencia interna. Cuando notifiques un error relacionado con una llamada a la API Graph, incluye el valor de fbtrace_id a fin de que podamos encontrar los datos de registro para la depuración. Sin embargo, este identificador caducará en breve. Para ayudar al equipo de asistencia a reproducir el problema, adjunta una sesión del explorador de la API Graph guardada.

Códigos de error

Código o tipo	Nombre	Qué hacer
OAuthException		Si no hay ningún subcódigo, significa que el identificador de acceso o el estado de inicio de sesión ha caducado, se ha revocado o no es válido por algún otro motivo. Obtén un nuevo identificador de acceso. Si hay un subcódigo, consúltalo.
102	Sesión de API	Si no hay ningún subcódigo, significa que el identificador de acceso o el estado de inicio de sesión ha caducado, se ha revocado o no es válido por algún otro motivo. Obtén un nuevo identificador de acceso. Si hay un subcódigo, consúltalo.
1	API desconocida	Posible problema temporal por inactividad. Vuelve a intentar la operación tras la espera. Si vuelve a producirse, comprueba que estás solicitando una API existente.
2	Servicio de API	Problema temporal por inactividad. Vuelve a intentar la operación tras la espera.
3	Método de la API	Problema con una función o permisos. Asegúrate de que la aplicación cuente con los permisos o las funciones necesarios para hacer esta llamada.
4	Demasiadas llamadas a la API	Problema temporal por restricción. Reintenta la operación tras la espera o examina el volumen de solicitudes de la API.
17	Demasiadas llamadas de usuario a la API	Problema temporal por restricción. Reintenta la operación tras la espera o examina el volumen de solicitudes de la API.
10	Permiso de API denegado	No se ha concedido un permiso o se ha eliminado. Gestiona los permisos que faltan.
190	El identificador de acceso ha caducado	Obtén un nuevo identificador de acceso.
200-299	Permiso de API (varios valores en función del permiso)	No se ha concedido un permiso o se ha eliminado. Gestiona los permisos que faltan.
341	Límite de aplicación alcanzado	Problema temporal por inactividad o restricción. Reintenta la operación tras la espera o examina el volumen de solicitudes de la API.
368	Bloqueado temporalmente por incumplimiento de las políticas	Vuelve a intentar la operación tras la espera.
506	Publicación duplicada	No se pueden realizar publicaciones duplicadas de forma consecutiva. Cambia el contenido de la publicación e inténtalo de nuevo.
1609005	Error de publicación de enlace	Ha habido un problema al extraer los datos del enlace proporcionado. Comprueba la URL e inténtalo de nuevo.

Subcódigos de error de autenticación

Código	Nombre	Qué hacer
458	Aplicación no instalada	El usuario no ha iniciado sesión en tu aplicación. Vuelve a autenticarlo.
459	Usuario marcado	El usuario debe iniciar sesión en https://www.facebook.com o https://m.facebook.com para corregir un problema.
460	Se ha cambiado la contraseña	En iOS 6 y versiones posteriores, si la persona ha iniciado sesión con el proceso integrado en el SO, redirígela a la configuración del SO de Facebook del dispositivo para actualizar su contraseña. De lo contrario, deberá iniciar sesión de nuevo en la aplicación.
463	Caducado	Identificador de acceso o estado de inicio de sesión caducado, revocado o no válido por otros motivos. Gestiona los identificadores de acceso caducados.
464	Usuario no confirmado	El usuario debe iniciar sesión en https://www.facebook.com o https://m.facebook.com para corregir un problema.
467	Identificador de acceso no válido	El identificador de acceso ha caducado, se ha revocado o no es válido por otros motivos. Gestiona los identificadores de acceso caducados.
492	Sesión no válida	El usuario asociado con el identificador de acceso a la página no tiene ningún rol adecuado en la página.

Códigos de error de limitación de frecuencia

Visita la guía de limitaciones de frecuencia de la API Graph para obtener más información sobre los códigos de error de dichas limitaciones.