¿Qué es la API de Visualización Básica de Instagram?

La API de visualización básica permite a los usuarios de aplicaciones de terceros acceder a datos básicos de su perfil de Instagram, incluidas fotos y videos. Sin embargo, esta API es limitada y está destinada a cuentas personales (no empresariales ni de creadores). Si necesitas funcionalidades avanzadas como moderar comentarios, publicar contenido o acceder a datos de otros usuarios, necesitarás usar la Instagram API junto con el inicio de sesión con Facebook.

¿Por qué es importante la migración?

Si tu aplicación depende de la API de visualización básica, dejará de funcionar el 4 de diciembre de 2024. La migración a la API de Instagram te permitirá:

- Acceder a datos de cuentas empresariales y de creadores.
- Publicar contenido multimedia.
- Moderar comentarios y menciones.
- Obtener insights y estadísticas de cuentas.

Pasos para la Migración a Instagram Graph API

1. Registro en Facebook Developer
Para usar la API de Instagram Graph, primero necesitas registrar tu aplicación en Facebook Developer.

1. Ve a [developers.facebook.com](https://developers.facebook.com/).
2. Crea una cuenta o inicia sesión.
3. En el panel de control, selecciona Create App.
4. Elige el tipo de app según lo que necesites (en la mayoría de los casos, selecciona "Business").
5. Configura tu aplicación y toma nota del App ID y App Secret, que necesitarás para las autenticaciones.

2. Configuración de Instagram Basic Display API
Aunque la API de visualización básica dejará de estar disponible, es importante haber configurado correctamente la aplicación para realizar la migración sin problemas.

1. En el panel de tu aplicación en Facebook Developer, ve a la sección Products y selecciona Instagram.
2. Activa el producto Instagram Basic Display para garantizar que la información se haya integrado correctamente.
3. Completa el App Review si es necesario (esto es crucial para aplicaciones públicas).

3. Implementación de OAuth (Autenticación)
La autenticación para usar la Instagram Graph API se realiza a través de OAuth 2.0. Sigue estos pasos para configurar correctamente tu app:

1. Dirige al usuario a la URL de autenticación de Instagram/Facebook:
   

url
   https://www.facebook.com/v16.0/dialog/oauth?client_id={app-id}&redirect_uri={redirect-uri}&scope={permissions}&response_type=code

   Donde:
   - app-id es el ID de tu aplicación de Facebook.
   - redirect-uri es la URL a la que el usuario será redirigido tras el inicio de sesión.
   - permissions son los permisos que tu app necesita. Ejemplo: `instagram_basic, instagram_manage_comments, instagram_manage_insights`.

2. Una vez que el usuario otorga permisos, recibirás un código de autorización en la `redirect-uri`.

3. Intercambia este código por un Access Token con una solicitud POST:
   

bash
   POST https://graph.facebook.com/v16.0/oauth/access_token
   - client_id={app-id}
   - redirect_uri={redirect-uri}
   - client_secret={app-secret}
   - code={authorization-code}
   

4. Uso de Instagram Graph API
Con el Access Token generado, ya puedes hacer solicitudes a la Instagram API. Aquí te dejo algunos ejemplos de llamadas básicas:

Obtener Datos Básicos del Usuario

bash
GET https://graph.instagram.com/me?fields=id,username,media_count,account_type&access_token={access-token}

Obtener Medios del Usuario

bash
GET https://graph.instagram.com/me/media?fields=id,caption,media_type,media_url,timestamp&access_token={access-token}

Publicar Contenido (solo cuentas empresariales o de creadores)

bash
POST https://graph.facebook.com/{ig-user-id}/media
- access_token={access-token}
- image_url={url-de-la-imagen}
- caption={tu-descripción}

5. Manejo de Permisos y Revisiones
La Instagram Graph API requiere que solicites ciertos permisos adicionales, como `instagram_manage_comments` o `instagram_content_publish`, y que tu app pase por una revisión de Facebook si es pública.

1. Ve al panel de App Review en Facebook Developer.
2. Solicita los permisos necesarios para tu aplicación.
3. Sube los videos de demostración y documentación solicitada para la revisión de tu app.

6. Errores Comunes y Solución de Problemas
- Error de permisos insuficientes: Asegúrate de haber solicitado y obtenido todos los permisos necesarios.
- Access Token caducado: Usa el endpoint de Refresh Token para actualizar el token antes de que expire.
- Fallo en la revisión de la app: Verifica que tu app cumple con las políticas de Facebook e Instagram, y que has proporcionado la información correcta en la revisión.