Información general

La API de visualización básica de Instagram es una API basada en HTTP que las aplicaciones pueden utilizar para obtener el perfil, las imágenes, los vídeos y los álbumes de un usuario de Instagram.

Componentes

URL de base

• api.instagram.com: para obtener identificadores de acceso de usuario de Instagram
• graph.instagram.com: para obtener contenido multimedia y perfiles de usuario de Instagram

Versiones

La API admite el mismo protocolo de versiones y ciclo de lanzamiento que la API Graph de Facebook. Se lanzan versiones nuevas aproximadamente cada 3 meses y cada una solo estará disponible durante dos años. Una vez transcurrido este periodo, se retirará.

Para consultar una versión de la API concreta, incluye el número de versión en la ruta de la consulta después de la URL base. Por ejemplo:

https://graph.instagram.com/v11.0/10218560180051171/media

Si omites el número de versión de la solicitud, es posible que esta se resuelva con la versión especificada en el Panel de aplicaciones > Configuración > Opciones avanzadas > Actualizar la versión de la API.

Ventana de autorización

La ventana de autorización permite a la aplicación obtener códigos de autorización y permisos de los usuarios de la aplicación. Los códigos de autorización se pueden intercambiar por identificadores de acceso de usuario de Instagram, que se deben incluir al consultar el perfil de un usuario de la aplicación o su contenido multimedia.

Para implementar la ventana de autorización, consulta nuestra guía Obtener identificadores de acceso.

Códigos de autorización

Los códigos de autorización se pueden intercambiar por identificadores de acceso de usuario de Instagram de corta duración. Para obtener un código de autorización, implementa la ventana de autorización en la aplicación. Una vez que el usuario de una aplicación haya autenticado su identidad en la ventana y haya concedido a tu aplicación los permisos que necesita, se le redireccionará a la aplicación y se incluirá un código de autorización. A continuación, puedes utilizar la API para intercambiar el código por el identificador de acceso de usuario de Instagram de corta duración del usuario de la aplicación.

Los códigos de autorización son de corta duración y solo son válidos durante una hora.

Identificadores de acceso de usuario de Instagram

La autenticación de la API se gestiona mediante identificadores de acceso de usuario de Instagram que forman el protocolo OAuth 2.0. Los identificadores de acceso son específicos de la aplicación (exclusivos para cada pareja de usuario-aplicación) y pueden ser de corta o larga duración. Las solicitudes de API que realizan consultas en relación con usuarios de Instagram o su contenido multimedia deben incluir un identificador de acceso de usuario de Instagram.

Identificadores de acceso de corta duración

Los identificadores de acceso de corta duración son válidos durante una hora, pero se pueden intercambiar por identificadores de larga duración. Para obtener un identificador de acceso de corta duración, implementa la ventana de autorización en la aplicación. Una vez que el usuario autentique su identidad desde la ventana, lo volveremos a dirigir a la aplicación e incluiremos un código de autorización que podrás intercambiar por un identificador de acceso de corta duración.

Identificadores de acceso de larga duración

Los identificadores de corta duración que no han caducado se pueden intercambiar por identificadores de acceso de larga duración, que son válidos durante 60 días. Los identificadores de larga duración se pueden actualizar antes de que caduquen mediante una consulta al extremo GET /refresh_access_token.

Permisos

Los usuarios de tu aplicación serán los encargados de controlar la autorización de acceso a los datos mediante los permisos que se enumeran a continuación. Los usuarios deben conceder a la aplicación estos permisos desde la ventana de autorización para que la aplicación pueda acceder a sus datos.

• instagram_graph_user_profile: permite a la aplicación leer el nodo de usuario, que representa al usuario de Instagram, y los perímetros del nodo.
• instagram_graph_user_media: permite a la aplicación leer el nodo de contenido multimedia, que representa una imagen, un vídeo o un álbum, y los perímetros del nodo.

Los evaluadores de Instagram pueden conceder estos permisos a tu aplicación en cualquier momento. Para que los usuarios de la aplicación que no tienen ningún rol en ella puedan concederle estos permisos, cada permiso debe aprobarse antes para el acceso avanzado mediante el proceso de revisión de la aplicación y tu aplicación debe estar en modo activo.

Las concesiones de permisos de los usuarios de la aplicación con cuentas públicas son válidas durante 90 días. La actualización del identificador de acceso de larga duración de un usuario de la aplicación ampliará la concesión del permiso otros 90 días si el usuario de la aplicación que ha concedido el identificador tiene una cuenta pública. No obstante, si la cuenta del usuario de la aplicación es privada, la concesión del permiso no se puede ampliar y el usuario de la aplicación debe volver a conceder el permiso caducado a tu aplicación.

Evaluadores de Instagram

Para probar tu aplicación con un usuario de Instagram, antes es necesario enviar una invitación a la cuenta del usuario de Instagram y esta se debe aceptar. Se pueden enviar invitaciones desde la sección Evaluadores de Instagram del Panel de aplicaciones > Roles > pestaña Roles.

El usuario de Instagram puede aceptar las invitaciones desde la sección (icono de perfil) > Editar perfil > Aplicaciones y sitios web > Invitaciones de evaluador de la aplicación para móviles o el sitio web de Instagram después de iniciar sesión en su cuenta.

Recursos

Los datos de la API incluyen los usuarios de Instagram y su contenido multimedia (imágenes, vídeos y álbumes). Todos los datos están protegidos por permisos: para que la aplicación pueda acceder a los datos de un usuario, este debe otorgarle permiso para hacerlo desde la ventana de autorización.

Usuarios

Los usuarios de Instagram y sus perfiles se representan mediante nodos de usuario. Ten en cuenta que los identificadores de usuario de la API heredada de Instagram son incompatibles con la API de visualización básica de Instagram.

Contenido multimedia

Las fotos, los vídeos y los álbumes se representan mediante nodos de contenido multimedia y se crean para usuarios individuales.

Límites de frecuencia

Todas las solicitudes de extremos están sujetas a los Límites de frecuencia de la plataforma de la API Graph.

Puedes ver el consumo del recuento de llamadas actual de la aplicación desde el Panel de aplicaciones > Instagram > pestaña Límite de frecuencia de visualización básica después de añadir el producto Instagram a la aplicación.

Tipos de aplicaciones

Las aplicaciones designadas como de tipo empresarial no se admiten. Si tu aplicación es de tipo empresarial, utiliza la API Graph de Instagram o crea una nueva aplicación de otro tipo.

Revisión de la aplicación

Los evaluadores de Instagram pueden conceder permisos de Instagram a tu aplicación en cualquier momento. Para que los usuarios de la aplicación que no tienen ningún rol en ella puedan concederle permisos de Instagram, cada permiso debe aprobarse antes para el acceso avanzado mediante el proceso de revisión de la aplicación y tu aplicación debe estar en modo activo.

Una vez que hayas completado el desarrollo de la aplicación y tengas todo listo para cambiarla al modo activo, revisa nuestros documentos Revisión de la aplicación, Envíos de ejemplo y Motivos frecuentes de rechazo para obtener información acerca del proceso de revisión de la aplicación. Una vez que te hayas familiarizado con el proceso, puedes solicitar la aprobación para los permisos de la API de visualización básica de Instagram mediante el Panel de aplicaciones > Productos > Instagram > pestaña Visualización básica.

Si estás creando una aplicación con el único fin de generar identificadores de acceso con el generador de identificadores de usuario, no es necesario que la envíes para que supere la revisión de la aplicación. El generador de identificadores de usuario no requiere ningún permiso y se puede utilizar mientras la aplicación está en modo de desarrollo.

Verificación del negocio

Mientras la aplicación esté en modo de desarrollo, solo podrá acceder a los datos de cuentas de evaluador de Instagram. Para poder cambiar al modo activo de la aplicación y acceder a datos de cuentas que no sean de evaluador, antes debes completar la verificación de la empresa.

Funcionamiento

Para utilizar la API, antes debes obtener la ventana de autorización y presentarla a un usuario de la aplicación. El usuario de la aplicación autentica su identidad a través de la ventana y autoriza la aplicación a acceder a sus datos al otorgarle permisos específicos. Una vez autenticado, la ventana lo devuelve a la aplicación e incluye un código de autorización. Puedes capturar el código e intercambiarlo por un identificador de acceso de usuario de Instagram de corta duración. Una vez que tengas un identificador de corta duración, podrás utilizarlo para consultar los extremos de usuario y contenido multimedia a fin de obtener los datos a los que el usuario permita acceso a la aplicación, o bien intercambiarlo por un identificador de larga duración.

Herramientas

Generador de identificadores de usuario

El generador de identificadores de usuario de Instagram es una herramienta que puedes utilizar para generar rápidamente identificadores de acceso de usuario de Instagram de larga duración para cualquiera de tus cuentas públicas de Instagram. Resulta útil si estás evaluando la aplicación y no quieres molestarte en implementar la ventana de autorización o si estás utilizando un código que se puede copiar y pegar que ha proporcionado un servicio de terceros (p. ej., para mostrar tus propios datos de Instagram en tu sitio web).

Para que la herramienta funcione, es necesario activar la ventana de autorización, en la que puedes iniciar sesión con una cuenta pública de Instagram que hayas designado como cuenta de evaluador. Después de iniciar sesión, la herramienta generará un identificador de acceso de larga duración que podrás copiar y pegar. Ten en cuenta que solo se pueden generar identificadores para cuentas de Instagram públicas.

Puedes acceder al generador de identificadores desde el Panel de aplicaciones > Productos > Instagram > pestaña Visualización básica.

Si estás creando una aplicación con el único fin de generar identificadores de acceso con el generador de identificadores de usuario, no es necesario que la envíes para que supere la revisión de la aplicación. El generador de identificadores de usuario no requiere ningún permiso y se puede utilizar mientras la aplicación está en modo de desarrollo.

Siguientes pasos

Sigue nuestra guía de introducción para obtener información sobre cómo configurar una aplicación y realizar una solicitud de API básica.