Referencia de errores de la API de PinterestGuía completa de solución de problemas con soluciones
Referencia completa para errores de la API de Pinterest. Encuentra soluciones y resuelve problemas comunes de integración.
Categorías de Errores
Video
2 errors
Autenticación
2 errors
Límite de tasa
2 errors
Medios
2 errors
Todos los Códigos de Error
#Video
cover_image_urluser-errorAl cargar un video a Pinterest, también debes proporcionar una imagen de portada.
Solución:
Pinterest requiere una imagen de portada para todos los pins de video. Proporciona tanto cover_image_url como cover_image_content_type al cargar videos. La imagen de portada debe ser JPG o PNG.
cover_image_content_typeuser-errorAl cargar un video a Pinterest, también debes proporcionar una imagen de portada.
Solución:
Especifica el tipo de contenido de la imagen de portada (image/jpeg o image/png) junto con cover_image_url. Ambos campos son requeridos para cargas de video.
#Autenticación
unauthorizedrefresh-tokenEl token de acceso de Pinterest no es válido. Vuelve a conectar tu cuenta de Pinterest.
Solución:
Tu token de acceso de Pinterest ya no es válido. Esto puede suceder después de la expiración del token o si revocaste el acceso de la app. Vuelve a conectar tu cuenta en la configuración.
invalid tokenrefresh-tokenEl token de acceso de Pinterest no es válido. Vuelve a conectar tu cuenta de Pinterest.
Solución:
Tu token de autenticación está mal formado o expiró. Ve a la configuración de tu cuenta y vuelve a conectar tu cuenta de Pinterest para obtener un nuevo token válido.
#Límite de tasa
429retrySe alcanzó el límite de tasa de Pinterest. Inténtalo de nuevo más tarde.
Solución:
Has excedido los límites de tasa de Pinterest. Pinterest tiene límites de tasa diarios y por hora. Espera a que el límite de tasa se restablezca (típicamente dentro de una hora) antes de reintentar.
rate limitretrySe alcanzó el límite de tasa de Pinterest. Inténtalo de nuevo más tarde.
Solución:
Pinterest aplica límites de tasa para prevenir el abuso de la API. Reduce la frecuencia de tus solicitudes e implementa retroceso exponencial en tu lógica de reintento.
#Medios
invalid mediauser-errorFormato de medios no compatible con Pinterest. Usa JPG, PNG para imágenes o MP4 para videos.
Solución:
Pinterest admite: Imágenes (JPG, PNG), Videos (MP4, MOV). Convierte tus medios a uno de estos formatos compatibles antes de cargar.
unsupported formatuser-errorFormato de medios no compatible con Pinterest. Usa JPG, PNG para imágenes o MP4 para videos.
Solución:
Usa formatos compatibles - Imágenes: JPG o PNG. Videos: MP4 o MOV con códec H.264. Asegúrate de que tus archivos cumplan con las especificaciones técnicas de Pinterest.
Mejores Prácticas
Manejo de Errores
- →Siempre proporcionar imagen de portada para cargas de video
- →Implementar manejo de límite de tasa y retroceso
- →Validar formato de medios antes de cargar
- →Monitorear el estado de la API de Pinterest
Consejos de Prevención
- →Incluir cover_image_url para todos los videos
- →Usar JPG/PNG para imágenes, MP4/MOV para videos
- →Respetar límites de tasa (por hora y diarios)
- →Mantener tokens frescos y seguros
Necesitas Ayuda con Pinterest Integración?
Nuestra API maneja escenarios de error automáticamente con lógica de reintento inteligente y registro detallado.