Gestion des erreurs

Les requêtes envoyées à nos API peuvent générer plusieurs réponses différentes avec des erreurs. Le document suivant décrit les tactiques de récupération et fournit une liste de valeurs d’erreur en les associant à la tactique de récupération la plus couramment utilisée.

Réponses d’erreur

Ce qui suit représente une réponse d’erreur courante résultant d’une requête d’API qui a échoué :

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}

message : description compréhensible de l’erreur.
code : code d’erreur. Les valeurs courantes sont répertoriées ci-dessous, ainsi que les tactiques de récupération courantes.
error_subcode : informations supplémentaires sur l’erreur. Les valeurs courantes sont répertoriées ci-dessous.
error_user_msg : message à montrer à l’utilisateur. La langue du message est basée sur le paramètre régional de la requête d’API.
error_user_title : titre de la boîte de dialogue, s’il est affiché. La langue du message est basée sur le paramètre régional de la requête d’API.
fbtrace_id : identifiant de prise en charge interne. Quand vous signalez un bug lié à un appel de l’API Graph, ajoutez fbtrace_id pour nous aider à trouver les données de journal à des fins de débogage. Cependant, cet ID expire rapidement. Pour aider l'équipe d'assistance à reproduire votre problème, veuillez joindre l’enregistrement d’une session d’Explorateur de l’API Graph.

Codes d’erreur

Code ou type	Nom	Action requise
OAuthException		Si aucun sous-code n’est présent, la connexion ou le token d’accès a expiré, a été annulé ou n’est pas valide. Obtenez un nouveau token d’accès. Si un sous-code est présent, affichez-le.
102	Session de l’API	Si aucun sous-code n’est présent, la connexion ou le token d’accès a expiré, a été annulé ou n’est pas valide. Obtenez un nouveau token d’accès. Si un sous-code est présent, affichez-le.
1	API inconnue	Peut-être un problème temporaire dû à un temps d’arrêt. Attendez et retentez l’opération. Si cela se reproduit, vérifiez que vous interrogez une API existante.
2	Service d’API	Problème temporaire dû à un temps d’arrêt. Attendez et retentez l’opération.
3	Méthode d’API	Problème de fonctionnalité ou d’autorisation. Vérifiez que votre application dispose des fonctionnalités ou autorisations nécessaires pour cet appel.
4	Trop d’appels d’API	Problème temporaire dû à une régulation. Attendez et retentez l’opération, ou examinez votre volume de requêtes d’API.
17	Trop d’appels d’API par l’utilisateur	Problème temporaire dû à une limitation de bande passante. Attendez et retentez l’opération, ou examinez votre volume de requêtes API.
10	Autorisation de l’API refusée	L’autorisation n’a pas été accordée ou a été supprimée. Gérez les autorisations manquantes.
190	Le token d’accès a expiré	Obtenez un nouveau token d’accès.
200-299	Autorisation de l’API (plusieurs valeurs en fonction de l’autorisation)	L’autorisation n’a pas été accordée ou a été supprimée. Gérez les autorisations manquantes.
341	Nombre maximum de requêtes atteint	Problème temporaire dû à un temps d’arrêt ou à une régulation. Attendez et retentez l’opération, ou examinez votre volume de requêtes API.
368	Bloqué temporairement pour des violations de règles	Attendez et retentez l’opération.
506	Double publication	Les publications en double ne peuvent pas être publiées consécutivement. Modifiez le contenu de la publication et réessayez.
1609005	Erreur de publication du lien	Un problème s’est produit lors de la récupération des données du lien indiqué. Vérifiez l’adresse URL et réessayez.

Sous-codes d’erreur d’authentification

Code	Nom	Action requise
458	Application non installée	L’utilisateur n’est pas connecté à votre application. Authentifiez l’utilisateur à nouveau.
459	Utilisateur soumis à un point de contrôle	L’utilisateur doit se connecter à l’adresse https://www.facebook.com ou à l’adresse https://m.facebook.com pour corriger un problème.
460	Mot de passe modifié	Sur iOS 6 et les versions ultérieures, si la personne s’est connectée à l’aide du flux intégré au système d’exploitation, redirigez-la vers les paramètres du système d’exploitation Facebook sur l’appareil pour mettre à jour son mot de passe. Sinon, elle doit se reconnecter à l’application.
463	Expiré	L’état de la connexion ou le token d’accès a expiré, a été annulé ou n’est pas valide. Gérez les tokens d’accès expirés.
464	Utilisateur non confirmé	L’utilisateur·ice doit se connecter à l’adresse https://www.facebook.com ou à l’adresse https://m.facebook.com pour corriger un problème.
467	Token d’accès non valide	Le token d’accès a expiré, a été annulé ou n’est pas valide. Gérez les tokens d’accès expirés.
492	Session non valide	L'utilisateur associé au token d'accès de Page n'a pas de rôle approprié sur la Page.

Codes d'erreur de plafond

Pour en savoir plus sur les codes d’erreur de plafond, consultez le guide Plafonds de l’API Graph.