L’API Graph est le meilleur moyen d’insérer et de récupérer des données dans la plateforme

Facebook.

L’API Graph fourni une représentation des informations sur Facebook. II est composé de nœuds,
d’arêtes et de champs.

Puisque l’API Graph est basée sur le protocole HTTP, elle est compatible avec tous les langages qui
ont une bibliothèque HTTP, comme cURL ou urllib.

curl -i -X GET [Link]

"name": "Your Name",

"id": "YOUR-USER-ID"

URL d’hébergement

Presque toutes les demandes sont transmises à l’URL d’hébergement [Link].

Les importations de vidéos utilisent [Link].

Tokens d’accès

Presque tous les points de terminaison de l’API Graph exigent un token d’accès d’une certaine
nature. Votre demande peut donc en nécessiter un chaque fois que vous accédez à un point de
terminaison. Ils remplissent généralement deux fonctions :

Ils permettent à votre application d’accéder aux informations d’un utilisateur sans avoir besoin du
mot de passe de ce dernier ; Par exemple, votre application a besoin de l’e-mail d’un utilisateur pour
exécuter une fonction. Si l’utilisateur accepte d’autoriser votre application à récupérer son adresse e-
mail à partir de Facebook, il n’aura pas à saisir son mot de passe Facebook pour la récupération.

Ils nous permettent d’identifier votre application, son utilisateur et le type de données que celui-ci
permet à votre application de consulter.

Nœuds

Un nœud un objet individuel avec un identifiant unique. Il existe, par exemple, de nombreux objets
de type nœud d’utilisateur, chacun possédant un identifiant unique qui représente une personne sur
Facebook. Pages, Groupes, Publications, Photos et Commentaires sont des exemples de nœuds du
graphe social de Facebook.
exemple de cURL suivant est un appel vers le nœud d’utilisateur :

curl -i -X GET \

"[Link]

"name": "Your Name",

"id": "YOUR-USER-ID"

Métadonnées de nœud

Vous pouvez obtenir la liste de tous les champs, y compris le nom du champ, la description et le type
de données, d’un objet nœud, tel qu’un utilisateur, une page ou une photo.

Request :

curl -i -X GET \

"[Link]

metadata=1&access_token=ACCESS-TOKEN"

response :

"name": "Jane Smith",

"metadata": {

"fields": [

"name": "id",

"description": "The app user's App-Scoped User ID. This ID is unique to the app and cannot be
used by other apps.",

"type": "numeric string"

},

"name": "age_range",

"description": "The age segment for this person expressed as a minimum and maximum age.
For example, more than 18, less than 21.",

"type": "agerange"

}
 Le noeud /me

Le nœud /me est un point de terminaison spécial qui se transforme en ID d’objet de la personne ou
la Page dont le token d’accès est utilisé pour effectuer les appels d’API.

curl -i -X GET \

"[Link]

Arêtes

Une arête est une connexion entre deux nœuds. Par exemple, un nœud d’utilisateur peut être
connecté à des photos, et un nœud de photo peut être connecté à des commentaires.

curl -i -X GET \

[Link]

{
"data": [
{
"created_time": "2017-06-06T[Link]+0000",
"id": "1353272134728652"
},
{
"created_time": "2017-06-06T[Link]+0000",
"id": "1353269908062208"
}
],
}

Champs

Présentation
L’API Graph est le meilleur moyen d’insérer et de récupérer des données dans la plateforme
Facebook. Il s’agit d’une API basée sur le protocole HTTP qui permet aux apps d’avoir
recours à la programmation pour interroger des données, publier de nouvelles actualités, gérer
des publicités, importer des photos et réaliser un large éventail d’autres tâches.

Le nom de l’API Graph s’inspire de l’idée d’un « graphe social » : une représentation des
informations sur Facebook. II est composé de nœuds, d’arêtes et de champs. Généralement,
vous utilisez les nœuds pour obtenir des données sur un objet en particulier, les arêtes pour
obtenir des collections d’objets sur un objet unique et les champs pour obtenir des données sur
un objet unique ou sur chaque objet d’une collection. Dans notre documentation, nous
pouvons faire référence à un nœud et à une arête comme un « point de terminaison ». Par
exemple, « envoyer une demande GET au point de terminaison de l’utilisateur ».
HTTP
Tous les transferts de données sont conformes au protocole HTTP1.1 et tous les points de
terminaison nécessitent le protocole HTTPS. Puisque l’API Graph est basée sur le protocole
HTTP, elle est compatible avec tous les langages qui ont une bibliothèque HTTP, comme
cURL ou urllib. Cela signifie que vous pouvez utiliser l’API Graph directement dans votre
navigateur. Par exemple, demander cette URL dans votre navigateur…

[Link]

…équivaut à effectuer cette demande cURL :

curl -i -X GET "[Link]

Nous avons également activé la directive HSTS includeSubdomains sur [Link],

URL d’hébergement
Presque toutes les demandes sont transmises à l’URL d’hébergement [Link].
Les seules exceptions sont les importations de vidéos, qui utilisent graph-
[Link].

Tokens d’accès
Les tokens d’accès permettent à votre application d’accéder à l’API Graph. Presque tous les
points de terminaison de l’API Graph exigent un token d’accès d’une certaine nature. Votre
demande peut donc en nécessiter un chaque fois que vous accédez à un point de terminaison.
Ils remplissent généralement deux fonctions :

 Ils permettent à votre application d’accéder aux informations d’un utilisateur sans avoir
besoin du mot de passe de ce dernier ; Par exemple, votre application a besoin de l’e-mail
d’un utilisateur pour exécuter une fonction. Si l’utilisateur accepte d’autoriser votre
application à récupérer son adresse e-mail à partir de Facebook, il n’aura pas à saisir son mot
de passe Facebook pour la récupération.
 Ils nous permettent d’identifier votre application, son utilisateur et le type de données que
celui-ci permet à votre application de consulter.

Pour en savoir plus, consultez notre documentation sur les tokens d’accès.

Nœuds
Un nœud un objet individuel avec un identifiant unique. Il existe, par exemple, de nombreux
objets de type nœud d’utilisateur, chacun possédant un identifiant unique qui représente une
personne sur Facebook. Pages, Groupes, Publications, Photos et Commentaires sont des
exemples de nœuds du graphe social de Facebook.

L’exemple de cURL suivant est un appel vers le nœud d’utilisateur.

Cette demande renverra les données suivantes par défaut, au format JSON :

{
"name": "Your Name",
"id": "YOUR-USER-ID"
}

Métadonnées de nœud

Vous pouvez obtenir la liste de tous les champs, y compris le nom du champ, la description et
le type de données, d’un objet nœud, tel qu’un utilisateur, une page ou une photo. Envoyez
une demande GET pour un ID d’objet en incluant le paramètre metadata=1 :

curl -i -X GET \
"[Link]
metadata=1&access_token=ACCESS-TOKEN"

La réponse JSON contiendra la propriété metadata qui répertorie tous les champs pris en
charge pour le nœud en question :

{
"name": "Jane Smith",
"metadata": {
"fields": [
{
"name": "id",
"description": "The app user's App-Scoped User ID. This ID is
unique to the app and cannot be used by other apps.",
"type": "numeric string"
},
{
"name": "age_range",
"description": "The age segment for this person expressed as a
minimum and maximum age. For example, more than 18, less than 21.",
"type": "agerange"
},
{
"name": "birthday",
"description": "The person's birthday. This is a fixed format
string, like `MM/DD/YYYY`. However, people can control who can see the
year they were born separately from the month and day so this string can be
only the year (YYYY) or the month + day (MM/DD)",
"type": "string"
},
...

/me
Le nœud /me est un point de terminaison spécial qui se transforme en ID d’objet de la
personne ou la Page dont le token d’accès est utilisé pour effectuer les appels d’API. Si vous
disposiez d’un token d’accès utilisateur, vous pourriez récupérer le nom et l’ID d’un
utilisateur à l’aide de :
curl -i -X GET \
"[Link]

Arêtes
Une arête est une connexion entre deux nœuds. Par exemple, un nœud d’utilisateur peut être
connecté à des photos, et un nœud de photo peut être connecté à des commentaires.
L’exemple de cURL suivant renvoie une liste des photos publiées sur Facebook par une
personne.

curl -i -X GET \
"[Link]

Chaque ID renvoyé représente un nœud de photo et la date de sa publication sur Facebook.

{
"data": [
{
"created_time": "2017-06-06T[Link]+0000",
"id": "1353272134728652"
},
{
"created_time": "2017-06-06T[Link]+0000",
"id": "1353269908062208"
}
],
}

Champs
Les champs sont des propriétés de nœud. Lorsque vous interrogez un nœud ou une arête, il ou
elle renvoie un ensemble de champs par défaut, comme le montrent les exemples ci-dessus.
Toutefois, vous pouvez préciser les champs que vous voulez recevoir en utilisant le paramètre
fields et en répertoriant chaque champ.