Les erreurs API surviennent lorsque Facebook, Instagram ou YouTube ne répondent pas correctement aux demandes d’Osortoo. Elles sont généralement liées aux permissions, à des connexions expirées, aux limites des plateformes ou à des réponses corrompues. Voici les causes les plus fréquentes et comment les résoudre.

1. Permissions Facebook/Instagram expirées

Les plateformes expirent régulièrement les accès pour des raisons de sécurité.

Symptômes :

• publications introuvables
• comptes Instagram manquants
• commentaires qui ne chargent pas
• erreur API lors de l’import

Solution :
Facebook → Paramètres → Intégrations professionnelles → Supprimer Osortoo → Reconnecter Facebook + Instagram.

2. Absence du rôle Administrateur

Sans accès Admin, l’API bloque l’accès aux pages et aux commentaires.

Symptômes :

• Page absente
• Instagram manquant
• “API access denied”

Solution :
Demander le rôle Admin → Reconnecter Facebook.

3. Instagram non lié à une Page Facebook

L’accès API à Instagram nécessite une liaison IG ↔ Page Facebook.

Symptômes :

• erreur API lors de la sélection IG
• “aucun post trouvé”
• commentaires manquants

Solution :
Instagram → Paramètres → Compte → Partage vers d’autres apps → Connecter une Page → Reconnecter Osortoo.

4. Compte Instagram personnel

Les comptes personnels n’offrent pas d’accès API.

Symptômes :

• aucun post visible
• erreurs API répétées

Solution :
Passer en compte Professionnel (Business ou Creator).

5. Limites d’API (Rate Limits)

Meta limite le nombre de requêtes en peu de temps.

Symptômes :

• commentaires partiellement chargés
• posts manquants
• tirage bloqué en “Chargement”

Solution :
Attendre quelques minutes puis réessayer.

6. Commentaires supprimés ou masqués

L’API ne renvoie pas :

• les commentaires supprimés
• ceux en cours de modération
• ceux d’utilisateurs restreints
• les commentaires masqués

Symptôme :

• nombre de commentaires plus faible que prévu

Solution :
Aucun — ce comportement dépend de la plateforme.

7. Publication invalide ou modifiée

Un post modifié, restreint ou remplacé peut produire des erreurs API.

Symptômes :

• “Post not available”
• “Impossible de charger les commentaires”

Solution :
Recréer le tirage et réimporter la publication ou utiliser un autre post.

8. Temps de réponse lent ou timeout

Meta ou YouTube peuvent ralentir temporairement.

Symptômes :

• chargement très long
• erreurs API intermittentes

Solution :
Attendre et rafraîchir plus tard.

9. VPN ou bloqueurs de publicité

Les extensions peuvent bloquer les autorisations API.

Symptômes :

• pop-up de connexion bloquée
• permissions incomplètes
• “API connection failed”

Solution :
Désactiver : VPN, AdBlock, uBlock, extensions de confidentialité → reconnecter.

10. Navigateur obsolète

Les anciens navigateurs peuvent mal interpréter les réponses API.

Solution :
Utiliser :

• Chrome (recommandé)
• Firefox
• Edge

Éviter les anciens appareils ou versions obsolètes.

11. Page non sélectionnée lors du login

Si la Page n’est pas cochée lors de la fenêtre de permissions, l’API ne peut pas y accéder.

Symptômes :

• IG introuvable
• Page absente
• aucun post affiché

Solution :
Reconnecter Facebook et sélectionner toutes les Pages lorsque demandé.

12. Pannes Facebook/Instagram

Les interruptions globales de Meta peuvent bloquer temporairement l’API.

Solution :
Attendre que les services reviennent.

Quand contacter le support

Si le problème persiste même après la reconnexion :

📧 [email protected]

Inclure :

• ton email de compte
• le lien de la Page Facebook
• le @ de ton Instagram
• l’URL de la publication
• une capture du message d’erreur