Instagram, con su plataforma visualmente atractiva, se ha convertido en una herramienta poderosa para empresas, desarrolladores y creadores. Para mejorar la experiencia del usuario y facilitar una integración perfecta, Instagram proporciona dos herramientas esenciales: Instagram Graph API e Instagram Basic Display API. En este artículo, nos centraremos en las capacidades de Instagram Basic Display API y cómo se puede aprovechar para optimizar tu presencia en Instagram.
Instagram Basic Display API
La Instagram Basic Display API es una herramienta proporcionada por Instagram (una subsidiaria de Facebook) que permite a los desarrolladores acceder a información básica del usuario, contenido multimedia y otros datos de las cuentas de Instagram. Esta API está diseñada específicamente para escenarios donde se requiere acceso de solo lectura a los datos del usuario, lo que la hace adecuada para aplicaciones que se centran en mostrar contenido de Instagram o proporcionar experiencias personalizadas.
Configuración previa al acceso a la API
Requisitos:
1. Una cuenta de desarrollador de Facebook.
2. Una cuenta de Instagram de prueba.
3. Una página web (URL) para la redirección, para otorgar permiso a la aplicación para acceder a Instagram.
Pasos para la configuración:
- En la página de desarrollador, haz clic en Crear aplicación. Selecciona Otro para continuar.
2. Elige cliente como tipo de aplicación para Instagram basic display API
A continuación, completa tu información (nombre de la aplicación, correo electrónico de contacto) y continúa
3. Establece la URL de la plataforma. Ve a configuración > básico, haz clic en añadir plataforma en la parte inferior e introduce tu URL (la página web mencionada en el requisito).
4. Configura Instagram Basic API en el panel de control
Después de crear la aplicación, aparecerá un formulario con algunas cosas que deben guardarse y completarse.
El ID de la aplicación y el secreto serán necesarios más adelante.
5. Introduce la misma URL que antes en URI de redireccionamiento OAuth válido, URL de devolución de llamada de desautorización y solicitud de eliminación de datos, ya que esta aplicación es para fines de prueba.
Añade un probador al formulario, por ejemplo, si Alice quiere recuperar la información de Bob, introduce el nombre de usuario de la cuenta de Bob.
Después de añadir un usuario, el estado del usuario estará pendiente, ya que se necesita la autorización del usuario. Se recomienda utilizar la cuenta de prueba.
6. Inicia sesión en tu cuenta de Instagram de prueba, ve a configuración > permiso del sitio web > Aplicaciones y sitios web > Invitaciones de probadores. Acepta la invitación de prueba.
¡La configuración básica está completa!
¿Cómo solicitar la autorización?
Se necesita un código de autorización antes de usar la API, el tiempo de supervivencia de este código de autorización es de 1 hora. Para obtener el código, introduce la URL en este formulario:
https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri}
&scope=user_profile,user_media
&response_type=codeExplicación de los atributos:
App-id: El id de la aplicación es el app-id, esto se puede encontrar en la pantalla básica debajo de la aplicación Instagram basic display.
redirect_uri: la misma URL que el URI de redireccionamiento OAuth válido.
Recuerda no dejar espacio para toda la URL.
Después de hacer clic en Intro, irá a la página para permitir la autorización.
Después de permitir todo el acceso, se redirigirá a tu propia URL, con el parámetro de código adjunto a la URL, se verá así
https://www.example.com/?code=ABCD......#_
El código de autorización es el que está después de code=, recuerda eliminar el #_ ya que esta no es la parte del código de autorización.
¿Cómo usar Apidog para intercambiar el código por un token de acceso?
Apidog es una plataforma de desarrollo de API todo en uno que te permite diseñar, probar y documentar fácilmente tu API. Para aquellos que quieran probar la API de Instagram, usar Apidog es siempre la solución más fácil.
Convertir el código de autorización en token de acceso
Cambia el método a POST, introduce la URL:
https://api.instagram.com/oauth/access_token
Añade estos parámetros que son necesarios:
- client_id = ID de la aplicación de Instagram
- client_secret = Secreto de la aplicación de Instagram
- code = Código de autorización obtenido
- grant_type = authorization_code (Este valor está establecido)
- redirect_uri = tu propia URI
Haz clic en enviar, el token de acceso se devolverá en forma de archivo JSON, se verá así:
{
"access_token": "IGQWR9......",
"user_id": 7666070400110123
}Nota: el token también es válido durante 1 hora
¿Cómo usar el token de acceso y el ID de usuario para consultar la información de la cuenta?
Hay varias funciones que se pueden obtener usando la API básica de visualización de Instagram, a continuación, se muestran dos ejemplos de recuperación de información.
- acceder a la información básica de una cuenta
Solicitud de muestra usando curl:
curl -X GET \ 'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'Explicación de los parámetros:
- User_id: obtener del paso anterior
- Access_token: del paso anterior
- Fields: puede ser parcialmente opcional. Hay 4 tipos de campos disponibles:
1. Account_type: tipo de cuenta
2. Id: user_id
3. Media_count: número de publicaciones
4. Username: nombre de la cuentaSi quieres obtener estos cuatro, introdúcelos todos separados por comas (,)
El resultado de la devolución:
2. Recuperar la información de la publicación del usuario
Solicitud de muestra:
curl -X GET \
'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'Configurar en Apidog:
Para obtener más funciones con la API de visualización de Instagram, consulta:
Conclusión
En conclusión, la API de Instagram abre un mundo de posibilidades para que los desarrolladores interactúen con la plataforma de Instagram y creen aplicaciones innovadoras. Desde el acceso a la información del usuario y el contenido multimedia hasta la publicación de nuevas fotos y vídeos, la diversa gama de puntos finales permite a los desarrolladores adaptar sus aplicaciones a necesidades específicas.
