Códigos de error

En este documento se describen los mensajes de error que puede devolver la API de Instagram. En el ejemplo de respuesta que se incluye a continuación se muestra un ejemplo del código 3600 y el subcódigo 2207004 con los consiguientes códigos de error definidos.

Ejemplo de respuesta

{
  "error": 
    {
      "message": "The image size is too large.",
      "type": "OAuthException",
      "code": 36000,
      "error_subcode": 2207004,
      "is_transient": false,
      "error_user_title": "Image size too large",
      "error_user_msg": "The image is too large to download. It should be less than 8 MiB.",
      "fbtrace_id": "A6LJylpZRKw2xKLFsAP-cJh"
   }
 }

Códigos de error definidos

Código de estado HTTP	Código	Subcódigo	Mensaje de usuario	Solución recomendada
`400`	`-2`	`2207003`	`It takes too long to download the media.`	Se agotó el tiempo de espera al descargar el contenido multimedia. Vuelve a intentarlo.
`400`	`-2`	`2207020`	`The media you are trying to access has expired. Please try to upload again.`	Genera un nuevo identificador de contenedor y úsalo para intentarlo de nuevo.
`400`	`-1`	`2207001`		Error de servidor de Instagram. Vuelve a intentarlo.
`400`	`-1`	`2207032`	`Create media fail, please try to re-create media`	No se pudo crear un contenedor de archivos multimedia. Vuelve a intentarlo.
`400`	`-1`	`2207053`	`unknown upload error`	Se produjo un error desconocido durante la subida. Genera un nuevo contenedor y úsalo para intentarlo de nuevo. Esto solo debería afectar a las subidas de vídeos.
`400`	`1`	`2207057`	`Thumbnail offset must be greater than or equal to 0 and less than video duration, i.e.` {video-length}	El desplazamiento de la miniatura introducido está fuera de los límites de la duración del vídeo. Añade el desplazamiento correcto en milisegundos.
`400`	`4`	`2207051`	`We restrict certain activity to protect our community. Tell us if you think we made a mistake.`	Se sospecha que la acción de publicación es spam. Restringimos algunas actividades para proteger a nuestra comunidad. Infórmanos si puedes determinar que la acción de publicación no es spam.
`400`	`9`	`2207042`	`You reached maximum number of posts that is allowed to be published by Content Publishing API.`	El usuario de la aplicación ha alcanzado el límite de publicación diario. Indícale que lo intente de nuevo al día siguiente.
`400`	`24`	`2207006`	`The media with` {media-id} `cannot be found`	Posible error relacionado con los permisos debido a que falta alguno o a que el identificador ha caducado. Genera un nuevo contenedor y úsalo para intentarlo de nuevo.
`400`	`24`	`2207008`	`The media builder with creation id =` {creation-id} `does not exist or has been expired.`	Error temporal al publicar un contenedor. Inténtalo de nuevo una o dos veces entre los 30 segundos y los 2 minutos siguientes. Si la operación no se completa correctamente, genera un nuevo identificador de contenedor y úsalo para volver a intentarlo.
`400`	`25`	`2207050`	`The Instagram account is restricted.`	La cuenta profesional de Instagram del usuario de la aplicación se encuentra inactiva, restringida o en un punto de control. Indica al usuario que inicie sesión en la aplicación de Instagram y que complete las acciones que esta necesite para volver a activar la cuenta.
`400`	`100`	`2207023`	`The media type` {media-type} `is unknown.`	El tipo de contenido multimedia no es uno de los esperados. Introduce el tipo correcto.
`400`	`100`	`2207028`	`Your post won't work as a carousel. Carousels need at least 2 photos/videos and no more than 10 photos/videos.`	Vuelve a intentarlo con un número aceptable de fotos o vídeos.
`400`	`100`	`2207035`	`Product tag positions should not be specified for video media.`	Los vídeos no admiten las coordenadas X/Y. No permitas que se usen las coordenadas X/Y con los vídeos.
`400`	`100`	`2207036`	`Product tag positions are required for photo media.`	Las etiquetas de productos de las imágenes deben incluir las coordenadas X/Y. Haz que las coordenadas X/Y sean obligatorias en el caso de las imágenes.
`400`	`100`	`2207037`	`We couldn't add all of your product tags. The product ID may be incorrect, the product may be deleted, or you may not have permission to tag the product.`	Uno o varios de los productos que se utilizan para etiquetar el artículo no son válidos (se han eliminado, se han rechazado, el usuario de la aplicación carece de permiso, el identificador del producto no es válido, etc.). Vuelve a obtener los productos que cumplen los requisitos y los catálogos del usuario de la aplicación y permítele utilizar los identificadores de estos productos solo durante el etiquetado.
`400`	`100`	`2207040`	`Cannot use more than` {max-tag-count} `tags per created media.`	El usuario de la aplicación ha superado el número máximo (20) de etiquetas con @. Indica al usuario que use menos etiquetas con @.
`400`	`352`	`2207026`	`The video format is not supported. Please check spec for supported` {video} `format`	Formato de vídeo no admitido. Indica al usuario de la aplicación que suba un archivo MOV o MP4 (MPEG-4 Parte 14). Consulta Especificaciones de vídeo.
`400`	`9004`	`2207052`	`The media could not be fetched from this uri:` {uri}	No se pudo recuperar el contenido multimedia del URI proporcionado. Indica al usuario de la aplicación que se asegure de que el URI es válido y está disponible para el público.
`400`	`9007`	`2207027`	`The media is not ready for publishing, please wait for a moment`	Comprueba el estado del contenedor y realiza la publicación cuando el estado sea `FINISHED`.
`400`	`36000`	`2207004`	`The image is too large to download. It should be less than` {size}`.`	La imagen superó el tamaño de archivo máximo de 8 MiB. Indica al usuario que lo intente de nuevo con una imagen de menor tamaño.
`400`	`36001`	`2207005`	`The image format` {current-image-format} `is not supported. Supported formats are:` {format}`.`	Posible error relacionado con los permisos debido a que falta alguno o a que el identificador ha caducado. Genera un nuevo contenedor y úsalo para intentarlo de nuevo.
`400`	`36003`	`2207009`	`The submitted image with aspect ratio` {submitted-ratio} `cannot be published. Please submit an image with a valid aspect ratio.`	La relación de aspecto de la imagen no entra dentro del intervalo aceptable. Indica al usuario de la aplicación que lo intente de nuevo con una imagen que entre dentro del intervalo comprendido entre 4:5 y 1,91:1.
`400`	`36004`	`2207010`	`The submitted image's caption was` {submitted-caption-length} `characters long. The maximum number of characters permitted for a caption is` {maximum-caption-length}. `Please submit media with a shorter caption.`	El usuario ha superado la cantidad máxima de caracteres para un subtítulo. Indica al usuario que utilice un subtítulo más corto. Se admiten como máximo 2200 caracteres, 30 hashtags y 20 etiquetas con @.
`400`	`100`	`9050`	`Provide either user_id or ig_user_id, not both.`	`/ig_audio` ha recibido `user_id` y `ig_user_id`. Enviar solo uno; preferir `ig_user_id`.
`400`	`100`	`9052`	`Missing or invalid purpose for product=ADS.`	Establece `purpose=AUDIO_COPYRIGHT_REPLACEMENT`, que es el único caso de uso secundario admitido actualmente para `product=ADS`.
`400`	`100`	`9056`	`Missing required parameter audio_replacement_mode.`	Envía `audio_replacement_mode` como uno de `auto`, `search` o `default`.
`400`	`100`	`9057`	`Invalid audio_replacement_mode value.`	Usa uno de estos valores: `auto`, `search` o `default` (no distingue entre mayúsculas y minúsculas).
`400`	`100`	`9058`	`Missing required parameter search_query.`	`search_query` es obligatorio cuando `audio_replacement_mode=search`. Anexa un término de búsqueda.
`400`	`100`	`9060`	`The search_query parameter is only valid when audio_replacement_mode=search.`	Anula `search_query` en los modos `auto` o `default`, o establece `audio_replacement_mode=search`.
`400`	`100`	`9054`	`The ig_media_id parameter is required.`	Proporciona el identificador de Facebook (de `/me/media`) del contenido multimedia de Instagram del reel cuya música protegida por derechos de autor se va a reemplazar.
`400`	`100`	`9062`	`The supplied ig_media_id refers to a non-Reel media.`	La detección de cambio de pistas de audio solo admite reels. Proporciona el identificador de Facebook de un reel.
`400`	`100`	`9055`	`This media does not contain copyrighted licensed music.`	La detección de cambio de pistas de audio solo está disponible para los reels con música protegida por derechos de autor. Elige un reel con un problema de derechos de autor.
`400`	`100`	`9063`	`The supplied partnership_ad_code is invalid or expired.`	Genera un código de anuncio entre socios válido y vuelve a intentarlo.
`400`	`100`	`9064`	`The supplied partnership_ad_code does not match the ig_media_id.`	Usa un `partnership_ad_code` generado para el mismo contenido multimedia que `ig_media_id`.
`403`	`200`		`The calling app is missing the ads_management permission for the target.`	Solicita y obtén el permiso `ads_management` para el usuario de destino y vuelve a intentarlo.
`403`	`10`	`9053`	`Ads audio swap discovery is not yet available.`	Esta función tiene un lanzamiento limitado. El acceso está restringido; ponte en contacto con tu socio de Meta.