Referencia de Errores de la API de FacebookGuía completa de solución de problemas con soluciones
Referencia completa para errores de la API de Facebook Graph. Encuentra soluciones para problemas de autenticación, violaciones de contenido, límites de tasa y problemas de medios.
Categorías de Errores
Autenticación
4 códigos de error
Medios
1 códigos de error
Limitación de tasa
1 códigos de error
Política de contenido
3 códigos de error
Formato de contenido
4 códigos de error
Servicio
2 códigos de error
Todos los Códigos de Error
#Autenticación
Error validating access tokenrefresh-tokenEl token de acceso de Facebook no es válido. Vuelve a conectar tu cuenta de Facebook.
Solución:
Esto significa que tu token de acceso de Facebook ya no es válido. Debes volver a conectar tu cuenta de Facebook para obtener un nuevo token válido. Ve a la configuración de tu cuenta y reconecta Facebook.
490refresh-tokenSesión de Facebook expirada. Vuelve a conectar tu cuenta de Facebook.
Solución:
Tu sesión de Facebook ha expirado. Esto suele suceder después de cierto tiempo o si cambiaste tu contraseña de Facebook. Vuelve a conectar tu cuenta de Facebook para establecer una nueva sesión.
REVOKED_ACCESS_TOKENrefresh-tokenEl token de acceso de Facebook fue revocado. Vuelve a conectar tu cuenta de Facebook.
Solución:
Tu token de acceso fue revocado, ya sea porque eliminaste la app en la configuración de Facebook o por los sistemas de seguridad de Facebook. Debes volver a conectar tu cuenta de Facebook.
1404078refresh-tokenSe requiere autorización para publicar en la página. Vuelve a conectar tu cuenta de Facebook.
Solución:
La app necesita permisos para publicar en páginas. Asegúrate de conceder todos los permisos requeridos al reconectar, especialmente el permiso 'pages_manage_posts'.
#Medios
1366046user-errorLas fotos deben ser menores a 4 MB y estar en formato JPG o PNG.
Solución:
Comprime tu imagen o usa otro formato. Facebook solo acepta imágenes JPG y PNG de menos de 4 MB. Usa una herramienta de compresión para reducir el tamaño del archivo.
#Limitación de tasa
1390008retryEstás publicando demasiado rápido. Espera un momento e inténtalo de nuevo.
Solución:
Facebook tiene límites de tasa para evitar el spam. Espera unos minutos antes de intentar publicar de nuevo. Si programas múltiples publicaciones, añade más tiempo entre ellas.
#Política de contenido
1346003user-errorEl contenido fue marcado por Facebook como posiblemente abusivo o inapropiado.
Solución:
Revisa tu contenido para asegurarte de que cumpla con los Estándares de la Comunidad de Facebook. Elimina cualquier contenido potencialmente ofensivo o inapropiado antes de publicar.
1404006user-errorNo se pudo publicar tu contenido. Puede requerirse una verificación de seguridad en Facebook.
Solución:
Los sistemas de seguridad de Facebook marcaron tu contenido o tu cuenta. Inicia sesión directamente en Facebook y completa cualquier verificación de seguridad requerida. Puede que necesites verificar tu identidad.
1404102user-errorEl contenido viola los Estándares de la Comunidad de Facebook. Revisa tu publicación.
Solución:
Tu contenido infringe los Estándares de la Comunidad de Facebook. Revisa los estándares en facebook.com/communitystandards y modifica tu contenido para cumplir con ellos.
#Formato de contenido
1609008user-errorNo se pueden publicar enlaces a Facebook.com.
Solución:
Facebook no permite publicar enlaces a dominios de facebook.com. Elimina cualquier enlace de Facebook del contenido de tu publicación.
2061006user-errorFormato de URL inválido en el contenido de la publicación.
Solución:
Comprueba que todas las URL en tu publicación estén correctamente formateadas (por ejemplo, comenzando con http:// o https://). Elimina o corrige cualquier URL mal formada.
1349125user-errorFormato de contenido inválido.
Solución:
Revisa el formato de tu publicación. Asegúrate de usar los parámetros correctos de la API y que la estructura de tu contenido cumpla con los requisitos de Facebook.
Name parameter too longuser-errorEl contenido de la publicación es demasiado largo.
Solución:
Facebook tiene límites de caracteres para las publicaciones. Acorta tu contenido o divídelo en varias publicaciones. La longitud máxima suele ser de 63.206 caracteres.
#Servicio
1363047retryServicio de Facebook temporalmente no disponible. Inténtalo más tarde.
Solución:
Los servidores de Facebook están experimentando problemas. Espera unos minutos e inténtalo nuevamente. Si el problema persiste, revisa la página de Estado de la Plataforma de Facebook.
1609010retryServicio de Facebook temporalmente no disponible. Inténtalo más tarde.
Solución:
Este es un problema temporal del servicio de Facebook. Espera unos minutos antes de reintentar tu solicitud. El sistema volverá a intentarlo automáticamente por ti.
Mejores Prácticas
Manejo de Errores
- →Implementar reintentos automáticos para límites de tasa y errores de servicio
- →Almacenar tokens de actualización de forma segura y manejar flujos de actualización de tokens
- →Registrar todos los errores con contexto para depuración
- →Mostrar mensajes de error amigables en tu interfaz de usuario
Consejos de Prevención
- →Validar contenido antes de enviarlo a la API de Facebook
- →Comprimir imágenes y optimizar medios antes de cargar
- →Implementar limitación de tasa en tu aplicación
- →Monitorear regularmente el Estado de la Plataforma de Facebook
¿Necesitas Ayuda con Facebook Integración?
Nuestra API maneja escenarios de error automáticamente con lógica de reintento inteligente y registro detallado.