Qu’est-ce que l’API Facebook ?
L’API Facebook est un ensemble de solutions utilisées comme principal moyen d’obtenir des données depuis et vers la plateforme. Elle permet aux développeurs et aux utilisateurs d’applications d’accéder à la fonctionnalité de ce réseau : informations utilisateur, photos et vidéos, messages, et plus encore.
BONUS : Créez votre widget de flux Facebook en quelques minutes !
Comment obtenir la clé de l’API Facebook.
Si vous souhaitez obtenir accès à la clé de l’API Facebook, vous devez vous inscrire ou vous connecter avec votre compte Facebook existant sur le portail des développeurs et approuver votre identité. Cela ne prendra que quelques étapes simples :
- Étape 1. Connectez-vous ou créez un compte
Allez sur le portail Facebook pour les développeurs et cliquez sur « Se connecter ». Vous pouvez vous connecter avec votre compte Facebook existant ou en créer un nouveau
- Étape 2. Commencez
Lorsque vous vous trouvez dans le service, appuyez sur « Commencer » dans le coin supérieur droit de la page principale
- Étape 3. Vérifiez votre compte
Pour commencer à travailler avec les outils des développeurs, vous devez approuver votre compte. Cliquez sur « Suivant » dans la fenêtre contextuelle qui s’affiche
Vous pouvez vérifier votre compte en utilisant votre numéro de téléphone ou une carte de crédit. Pour le faire via un numéro de téléphone, choisissez votre pays dans le menu déroulant, saisissez votre numéro de téléphone avec le code pays et cliquez sur « Envoyer par SMS ». Saisissez le code obtenu dans le champ et cliquez sur « Vérifier »
- Étape 4. Créez votre application
Ensuite, le service vous proposera de créer votre première application. Toutes les API et statistiques d’applications Facebook sont suivies dans le tableau de bord des développeurs, et elles ne peuvent pas être consultées sans créer une application.
- Étape 5. Ajoutez les applications ou générez des jetons d’accès selon vos besoins
La manière la plus facile et la plus pratique d’utiliser les API Facebook est d’ajouter les applications directement dans le tableau de bord. Choisissez simplement celle qui correspond à vos besoins.
Allez dans Outils – Explorateur Graph API pour générer des jetons d’accès pour différents types d’API que vous souhaitez utiliser dans votre application. Choisissez l’application et le type de jeton dont vous avez besoin dans les menus déroulants à gauche de l’écran. Ensuite, cliquez sur « Générer un jeton d’accès ». Vous devrez approuver l’accès de l’application à votre page.
Comment utiliser des exemples d’API Facebook
Le produit principal est l’API Graph, qui sert de base à tous les autres types d’API Facebook. Ils sont essentiellement des extensions de l’API Graph, et tous les produits Facebook interagissent avec lui d’une manière ou d’une autre.
Quelle utilisation pouvez-vous faire de la console des développeurs Facebook et des produits fournis là-bas ? Il existe de nombreuses façons de mettre à niveau votre site web ou votre application en utilisant le contenu et certaines des fonctionnalités de cette plateforme sociale.
Vous pouvez afficher différents types de contenu sur les réseaux sociaux – publications, images, vidéos – sur votre site web ou votre application pour engager et divertir les utilisateurs.
Mais gardez à l’esprit que lorsque l’API Graph est implémentée pour être utilisée par d’autres utilisateurs, ils devront également l’approuver d’abord dans une fenêtre contextuelle. Seulement après l’autorisation de l’utilisateur, l’application obtiendra un jeton d’accès de cet utilisateur et pourra utiliser ses informations depuis son profil Facebook.
Limites de l’API Facebook
N’oubliez pas que chaque type d’API a toujours des limitations. Les requêtes de l’API Graph effectuées avec le jeton d’accès de l’application sont comptabilisées selon la limite de taux de cette application. Le nombre d’appels de chaque application est le nombre de requêtes qu’elle peut effectuer pendant une période d’une heure et est calculé comme suit :Appels dans une heure = 200 * Nombre d'utilisateurs de l'application
Intégration de l’API Facebook
La plateforme fournit plusieurs solutions préfabriquées pour les non-développeurs sur la base de son API Graph. Toutes les applications et API Facebook sont en essence un ensemble ou une collection de nœuds de l’API Graph. Cela signifie que vous devez toujours compléter les Étapes 1 à 3 décrites ci-dessus pour créer un compte et obtenir accès au tableau de bord. Ci-dessous, nous décrivons les applications standard de l’API Facebook les plus couramment utilisées.
Types d’API Facebook Feed
API de la Page Facebook
Ce type d’API permet d’accéder aux paramètres, au contenu et aux métriques d’une page. Il vous permet de créer et d’afficher des publications, des commentaires d’une page, du contenu détenu par la page, et plus encore. Tous les détails peuvent être trouvés dans la Documentation de l’API Pages. N’oubliez pas que vous avez besoin d’un jeton d’accès d’un utilisateur d’application qui possède ou peut effectuer une tâche requise sur la page.
API Vidéo Facebook
Facebook propose deux types d’API – API Vidéo et API Vidéo en direct. Les deux permettent de publier des vidéos sur une page, un groupe ou un événement administré par un utilisateur d’application. L’API Vidéo est destinée à la publication de vidéos courtes et longues sur une ou plusieurs pages et groupes. L’API Vidéo en direct, quant à elle, est utilisée pour planifier une diffusion en direct, diffuser une vidéo sur un profil utilisateur, un groupe ou un événement et interagir avec le public. Et bien sûr, vous avez besoin de jetons d’accès aux pages, aux groupes ou aux événements ou d’une combinaison d’entre eux selon l’endroit où vous voulez placer votre vidéo ou votre diffusion en direct.
Événements de l'API Facebook
Ce type d’API est également présenté sous forme de fonctionnalité de l’API Graph, mais il n’est disponible que pour les partenaires marketing Facebook. Il nécessite également un jeton d’accès de l’administrateur de l’événement ou d’un groupe qui a créé cet événement.
API Fil d'actualité Facebook
Vous avez deux options pour accéder et utiliser le fil d’actualité Facebook. L’API Graph décrite donne la possibilité d’accéder à un fil d’actualité utilisateur distinct de mises à jour de statut et d’obtenir des publications API et des liens publiés par l’utilisateur ou une autre personne sur le profil. Vous pouvez en savoir plus à ce sujet ici.
Il existe également une API de fil public, qui permet d’afficher le contenu marqué comme « Public » sur le service tiers ou le site web. Mais ce type de clé d’API n’est accordé qu’aux éditeurs de médias approuvés, donc vous devez d’abord faire une demande.
Vous n’avez pas besoin de l’API de Groupe Facebook pour afficher son contenu sur votre site web. Utilisez le widget d’alimentation Facebook! Avec lui, vous avez un contrôle total sur le contenu dont vous avez besoin.
API de la Communauté Facebook
API de Commentaire Facebook
L’accès aux commentaires sur Facebook peut être obtenu via l’API Graph. Comme les commentaires peuvent être laissés sous différents types de contenu, vous devez obtenir l’accès à un objet pour travailler avec les commentaires dessus.
API d'Avis Facebook
Cette partie de l’API Graph représente des objets contenant une recommandation. Les champs par défaut incluent la date, l’évaluation en étoiles, le texte de l’avis, les informations sur l’utilisateur, et le badge ‘positif’ ou ‘négatif’.
Si vous souhaitez avoir plus de contrôle sur les avis affichés, vous pouvez ajuster le Plugin d’Avis selon vos préférences.
API d’Outils Facebook
API de Connexion Facebook
L’exemple de connexion à l’API Facebook peut être vu sur de nombreux services web qui nécessitent une inscription. Cela offre aux utilisateurs un moyen rapide et sécurisé de se connecter à un site web ou une application. Cette API collecte les jetons d’accès des utilisateurs pour obtenir leurs informations de profil, ce qui est possible uniquement après l’approbation de l’utilisateur. Si vous souhaitez utiliser ce type d’API, vous devez faire examiner et approuver votre application par l’administration Facebook.
API Lieux Facebook
Places Graph est une solution Facebook distincte disponible uniquement pour les plates-formes Android et iOS. Avec lui, votre application peut obtenir des informations sur la localisation actuelle des utilisateurs. Il permet également la recherche et la découverte de lieux, le partage de localisation et le géomarquage. L’API des lieux nécessite également d’obtenir des jetons d’accès auprès des utilisateurs. Pour intégrer et commencer à travailler avec l’API des lieux, vous devez d’abord obtenir le SDK Facebook pour votre application.
API de Paiements Facebook
L’API de paiement inclut les détails d’un paiement effectué dans une certaine application. Ces paiements sont créés dans les paiements Facebook et traités sur la base de la plate-forme. Ce type d’API nécessite également un jeton d’accès pour une application qui crée un paiement.
API Messenger Facebook
L’API Messenger est une application qui vous permet d’organiser un canal de conversation sur votre site web à l’aide de Facebook Messenger. La solution Messenger API permet également à un développeur de construire une conversation guidée avec les utilisateurs. Ainsi, le messager peut répondre automatiquement à un utilisateur en utilisant l’API d’envoi (également appelée API de bot Facebook), qui envoie des webhooks à l’URL du serveur où est hébergé le messager.
Restez connecté avec vos clients et votre public de site web avec un Bouton Messenger gratuit et facile à installer!
Types d’API Marketing Facebook
API d'Annonces Facebook
L’API Marketing est un ensemble de points d’extrémité de l’API Graph qui aident à optimiser la publicité sur Facebook. L’API d’Annonces Facebook permet aux utilisateurs de créer et de gérer des campagnes publicitaires, des ensembles d’annonces et des unités d’annonce distinctes.
API Marketplace Facebook
Actuellement, seules les catégories Véhicules et Immobilier sont disponibles sur Facebook Marketplace. Pour accéder à cette section de la plate-forme Facebook, vous devez créer un compte développeur et vérifier votre entreprise. Cette solution propose d’utiliser l’API Lead avec des webhooks de développeur pour de meilleures performances. Pour cela, vous devez créer votre application comme décrit précédemment dans cet article et la soumettre à l’examen pour qu’elle soit approuvée par Facebook.
API Analytics Facebook
Cette solution aide à suivre et à optimiser le comportement et le parcours de vos clients à partir de ressources mobiles, web, bots, hors ligne, et autres. Pour la mettre en œuvre, vous devez intégrer le SDK Facebook dans votre application ou site web. Vous pouvez en savoir plus dans le Centre d’aide à l’Analytics Help Centre.
API du Gestionnaire d'entreprise Facebook
Derniers changements de l’API
Les changements de l’API Facebook comprennent des changements versionnés – ceux qui sont introduits avec la sortie d’une nouvelle version de l’API. Il y a aussi des changements non versionnés qui sont introduits en dehors des versions normales. Pour passer à une version plus récente de l’API Facebook, il existe un Outil de mise à niveau de l’API spécial.
La dernière version est la v8.0, fraîchement sortie en août 2020. Elle propose désormais :
- types d’applications – Entreprise, Jeu et Aucun
- obtention des J’aime pour les vidéos en direct
- Modèle de produit dans Messenger pour les Boutiques pour envoyer des produits sous forme de messages
La version précédente, la v7.0, sortie en mai 2020, sera disponible jusqu’en août 2022.
Statut et erreurs de l’API Facebook
Le statut actuel de la plateforme est sain depuis le 1er octobre 2020. Mais les requêtes effectuées donnent parfois lieu à diverses réponses d’erreur de l’API Facebook avec les codes d’erreur respectifs. Par exemple, l’erreur 400 de l’API Facebook – Mauvaise requête – signifie qu’une requête n’est plus prise en charge et que vous avez besoin d’un nouveau jeton d’accès à générer. Voici quelques autres :
| Code | Nom |
| 102 | Session API |
| 1 | API Inconnue |
| 2 | Service API |
| 3 | Méthode API |
| 4 | Trop d’appels API |
| 17 | Trop d’appels d’utilisateur API |
| 10 | Accès API refusé |
| 190 | Le jeton d’accès a expiré |
| 200-299 | Autorisation API (Multiples valeurs selon l’autorisation) |
| 341 | Limite d’application atteinte |
| 368 | Bloqué temporairement pour violations des politiques |
| 506 | Publication en double |
| 1609005 | Erreur lors de la publication du lien |
Documentation de l’API Facebook
La documentation de tous les types d’API de développeur Facebook se trouve dans la section Docs du portail des développeurs Facebook. La liste complète des nœuds racines de l’API Graph se trouve dans la section Référence de l’API Facebook. Chaque documentation d’API comprend un court tutoriel sur les autorisations requises, ainsi que sur la manière de l’utiliser et de l’implémenter. Elle se trouve dans les sections « Premiers pas » et « Guides » de chaque documentation spécifique.
