Administración de errores

Las solicitudes realizadas a nuestras API pueden obtener varias respuestas de error diferentes. El siguiente documento describe los métodos de recuperación y ofrece una lista de valores de error, junto con el método de recuperación más común para cada uno de ellos.

Respuestas de error

Lo siguiente representa una respuesta de error común que se genera a partir de una solicitud de API errónea:

{
  "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 en lenguaje natural del error.
code: código de error. Los valores comunes se especifican más adelante, junto con los métodos de recuperación habituales.
error_subcode: información adicional sobre el error. Los valores comunes se especifican más adelante.
error_user_msg: mensaje para 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, si aparece. El idioma del mensaje se basa en la configuración regional de la solicitud de la API.
fbtrace_id: identificador de compatibilidad interno. Al reportar un error relacionado con una llamada a la API Graph, incluye fbtrace_id para ayudarnos a encontrar datos de registro para realizar la depuración. Sin embargo, este identificador caducará rápidamente. Con el fin de ayudar al equipo de soporte a reproducir tu error, 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 existe un subcódigo, el estado de inicio de sesión o el token de acceso caducó, se revocó o no es válido. Obtén un nuevo token de acceso. Si existe un subcódigo, consúltalo.
102	Sesión de la API	Si no existe un subcódigo, el estado de inicio de sesión o el token de acceso caducó, se revocó o no es válido. Obtén un nuevo token de acceso. Si existe un subcódigo, consúltalo.
1	API desconocida	Puede ser un problema temporal debido a que la API no está disponible. Espera y vuelve a intentar la operación. Si vuelve a ocurrir, comprueba que estés enviando la solicitud a una API preexistente.
2	Servicio de API	Problema temporal debido a que la API no está disponible. Espera y vuelve a intentar la operación.
3	Método de la API	Problema de función o permisos. Asegúrate de que tu app tenga las funciones y los permisos necesarios para realizar esta llamada.
4	Demasiadas llamadas a la API	Problema temporal ocasionado por una limitación. Espera y vuelve a intentar la operación; o bien, revisa la cantidad de solicitudes que enviaste a la API.
17	Demasiadas llamadas de usuario a la API	Problema temporal ocasionado por una limitación. Espera y vuelve a intentar la operación; o bien, revisa la cantidad de solicitudes que enviaste a la API.
10	Permiso de API denegado	No se otorgó el permiso o se eliminó. Administra los permisos faltantes.
190	El token de acceso caducó	Obtén un nuevo token de acceso.
200-299	Permiso de API (varios valores según el permiso)	No se otorgó el permiso o se eliminó. Administra los permisos faltantes.
341	Límite de app alcanzado	Problema temporal ocasionado por un tiempo de inactividad o una limitación. Espera y vuelve a intentar la operación; o bien, revisa la cantidad de solicitudes que enviaste a la API.
368	Bloqueado temporalmente por infracción de las políticas	Espera y vuelve a intentar la operación.
506	Publicación duplicada	No se pueden hacer publicaciones duplicadas de manera consecutiva. Cambia el contenido de la publicación y vuelve a intentarlo.
1609005	Error en enlace de publicación	Hubo un problema al extraer los datos del enlace proporcionado. Comprueba la URL y vuelve a intentarlo.

Subcódigos de error de autenticación

Código	Nombre	Qué hacer
458	App no instalada	El usuario no inició sesión en la app. Vuelve a autenticar al usuario.
459	Usuario verificado	El usuario necesita iniciar sesión en https://www.facebook.com o https://m.facebook.com para corregir un problema.
460	Contraseña modificada	En iOS 6 y versiones posteriores, si la persona inició sesión con el proceso integrado en el sistema operativo, dirígela a la configuración del sistema operativo de Facebook en el dispositivo para actualizar su contraseña. De lo contrario, deberá volver a iniciar sesión en la app.
463	Caducado	El estado de inicio de sesión o el token de acceso caducó, se revocó o no es válido. Administra los tokens de acceso caducados.
464	Usuario no confirmado	El usuario necesita iniciar sesión en https://www.facebook.com o https://m.facebook.com para corregir un problema.
467	Token de acceso no válido	El token de acceso caducó, se revocó o no es válido. Administra los tokens de acceso caducados.
492	Sesión no válida	El usuario asociado con el token de acceso a la página no tiene el rol apropiado en la página.

Códigos de error de limitación de frecuencia

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