Referencia de Errores de la API de InstagramGuía completa de solución de problemas con soluciones

Solución:

Tu token de acceso de Instagram fue revocado. Esto sucede cuando eliminas los permisos de la app en la configuración de Instagram. Ve a la configuración de tu cuenta y vuelve a conectar Instagram con todos los permisos requeridos.

Solución:

Tu sesión de Instagram ya no es válida. Esto puede suceder después de un cambio de contraseña o verificación de seguridad. Vuelve a conectar tu cuenta de Instagram para establecer una nueva sesión.

Solución:

La API de Instagram requiere una cuenta Business o Creator. Convierte tu cuenta: Ve a Configuración de Instagram → Cuenta → Cambiar a cuenta profesional → Elegir Business.

Solución:

Instagram ha restringido tu cuenta. Inicia sesión directamente en Instagram para ver si hay advertencias o restricciones. Es posible que necesites verificar tu identidad o apelar la restricción.

Solución:

La app no tiene los permisos requeridos. Al reconectar, asegúrate de otorgar todos los permisos, especialmente 'instagram_content_publish' e 'instagram_basic'.

Solución:

Instagram no pudo descargar tu contenido desde la URL dentro del tiempo de espera. Asegúrate de que tu URL de contenido sea accesible públicamente y que el servidor esté respondiendo rápidamente. Intenta volver a subirlo.

Solución:

El contenedor de medios ha expirado antes de la publicación. Los contenedores de medios de Instagram caducan después de 24 horas. Crea un nuevo contenedor de medios y publícalo de inmediato.

Solución:

No se pudo crear el contenedor de medios en Instagram. Esto podría ser un problema temporal. Espera un momento y vuelve a intentarlo. Asegúrate de que tus medios cumplan con las especificaciones de Instagram.

Solución:

Se produjo un error desconocido durante la carga. Verifica que tu archivo multimedia sea válido y cumpla con los requisitos de Instagram. Intenta cargar un archivo diferente para aislar el problema.

Solución:

Instagram no pudo obtener tu contenido desde la URL proporcionada. Verifica que la URL sea accesible públicamente, que devuelva el encabezado de tipo de contenido correcto y que el archivo sea válido.

Solución:

No se encontró el contenedor de medios. Puede que haya sido eliminado o haya caducado. Crea un nuevo contenedor de medios y vuelve a intentarlo.

Solución:

La sesión del generador de medios ha expirado. Esto ocurre si ha pasado demasiado tiempo entre la creación del contenedor y la publicación. Crea y publica en un solo flujo.

Solución:

Se ha producido un error desconocido. Espera unos minutos y vuelve a intentarlo. Si el problema persiste, contacta con el soporte técnico proporcionando todos los detalles del error.

Solución:

Reduce el tamaño de tus archivos de imagen. Instagram tiene un tamaño máximo de archivo de 8 MB para imágenes. Utiliza una herramienta de compresión de imágenes para disminuir el tamaño del archivo sin perder calidad.

Solución:

Instagram solo admite formatos de imagen JPG y PNG. Convierte tu imagen a uno de estos formatos antes de subirla.

Solución:

Instagram requiere relaciones de aspecto entre 4:5 (vertical) y 1.91:1 (horizontal). Recorta o redimensiona tu imagen para que se ajuste a estos límites.

Solución:

La relación de aspecto de tu imagen está fuera del rango permitido por Instagram. Utiliza 1:1 (cuadrado), 4:5 (vertical) o 1.91:1 (horizontal). Evita relaciones de aspecto extremas.

Solución:

Instagram limita la resolución de las imágenes a 1920x1080 píxeles. Redimensiona tu imagen para que se ajuste a estas dimensiones.

Solución:

Instagram solo admite el formato de video MP4 con códec H.264 y audio AAC. Convierte tu video para cumplir con estas especificaciones.

Solución:

El desplazamiento de la miniatura que has especificado no es válido. Debe estar dentro de la duración del vídeo. Utiliza un valor entre 0 y la duración del vídeo en milisegundos.

Solución:

Instagram no pudo determinar el tipo de medio. Asegúrate de especificar correctamente el parámetro media_type (IMAGEN, VÍDEO o ÁLBUM_CARRUSEL).

Solución:

Las descripciones de Instagram tienen un límite máximo de 2,200 caracteres. Acorta tu descripción y vuelve a intentarlo.

Solución:

La detección de spam de Instagram ha marcado tu contenido. Evita publicaciones repetitivas, el uso excesivo de hashtags o un lenguaje que parezca spam. Espera un tiempo y prueba a publicar contenido diferente.

Solución:

Instagram ha bloqueado esta solicitud, probablemente debido a limitaciones de tasa o actividad sospechosa. Espera entre 15 y 30 minutos antes de intentar de nuevo y reduce la frecuencia de publicaciones.

Solución:

Tu carrusel no cumple con los requisitos de Instagram. Asegúrate de que todos los elementos sean del mismo tipo (todas imágenes o todos vídeos), tengan relaciones de aspecto consistentes y que contenga entre 2 y 10 elementos.

Solución:

No puedes especificar las posiciones de las etiquetas de producto para las publicaciones de video. Solo las publicaciones de imagen admiten etiquetas de producto posicionadas.

Solución:

Al etiquetar productos en las fotos, debes especificar las coordenadas x e y para las posiciones de las etiquetas. Proporciona los datos de posición para todas las etiquetas de productos.

Solución:

Uno o más etiquetas de producto son inválidas. Verifica que todos los IDs de producto existan en tu catálogo y que las coordenadas de posición estén entre 0.0 y 1.0.

Solución:

Instagram limita el número de etiquetas de productos por publicación. Reduce la cantidad de productos que estás etiquetando (el máximo suele ser 5 productos por imagen).

Solución:

Has alcanzado el límite diario de publicaciones de Instagram. Instagram permite 25 publicaciones al día. Espera hasta el día siguiente para publicar más contenido.

Solución:

Instagram impone un límite de 100 publicaciones por día. Espera hasta mañana para publicar más contenido. Considera programar tus publicaciones para distribuirlas a lo largo de varios días.

Solución:

Instagram ha experimentado un error temporal. El sistema intentará de nuevo automáticamente. Si sigue fallando, espera unos minutos antes de volver a intentarlo.