API Instagram Business – Express + TypeScript + MySQL (Prisma)

But: Lier un compte Instagram Business via Facebook Login, ingérer profil + médias, stocker dans MySQL et exposer une API REST. (Sans cron / webhook pour l'instant.)

Stack

• Node.js + TypeScript
• Express (routing léger)
• Prisma (ORM) + MySQL
• Axios (HTTP Graph API)
• Zod (validation)
• Pino (logs JSON)

Permissions demandées

public_profile,pages_show_list,pages_read_engagement,instagram_basic,business_management

Endpoints (MVP)

Méthode	Route	Description
GET	/health	Ping
GET	/auth/facebook/start	Génère URL d'auth Facebook
GET	/auth/facebook/callback	Échange code -> tokens + ingestion
GET	/accounts	Liste comptes IG
GET	/accounts/:igUserId/profile	Profil stocké
GET	/accounts/:igUserId/media?limit=20&before=...	Médias paginés
POST	/accounts/:igUserId/sync	Force re-sync (incrementale)

Flux Callback détaillé

1. Échange code -> short-lived token (OAuth endpoint).
2. Échange short -> long-lived token.
3. /me/accounts collecte pages avec instagram_business_account.
4. Pour chaque compte IG: profil + médias (batch initial).
5. Upsert profil & médias (ignorer doublons via igMediaId).
6. Réponse JSON => comptes créés/actualisés & nombre de médias ingérés.

Sécurité Tokens

• Chiffrés (AES-256-GCM) avant insertion.

Lancement (après scaffold généré)

npm install
npx prisma migrate dev --name init
npm run dev

Note migration

Les champs encryptedPageToken et encryptedUserToken sont passés en TEXT pour éviter toute coupure entraînant des erreurs de déchiffrement si la clé change. Lancer une migration puis relier les comptes si nécessaire.

---