Dépannage

Travailler avec l’API Marketing peut occasionnellement présenter des difficultés. Voici les problèmes que peuvent rencontrer les utilisateur·ices, ainsi que des solutions pratiques pour vous aider à rationaliser votre expérience.

Gestion des erreurs

Utilisez les techniques de traitement des erreurs et les recommandations ci-dessous pour améliorer la fiabilité et l’efficacité de vos applications.

Erreurs d’autorisation

Ces erreurs se produisent souvent à cause de jetons d’accès expirés, non valides ou ne disposant pas des autorisations requises. Pour atténuer ces problèmes, il convient de s’assurer que les jetons sont actualisés régulièrement et que les champs d’application corrects sont demandés lors de l’autorisation.

Paramètres non valides

L’envoi de requêtes présentant des paramètres incorrects ou manquants peut entraîner des erreurs. Validez toujours les données d’entrée avant de passer des appels d’API. L’utilisation d’outils de validation peut réduire considérablement ces erreurs.

Ressource introuvable

Cette erreur survient lorsque vous tentez d’accéder à une ressource qui n’existe pas ou qui a été supprimée. Pour résoudre ce problème, vérifiez la présence des ressources (comme des campagnes ou des ensembles de publicités) bien avant d’effectuer des opérations sur elles.

Plafond

L’API Marketing met en place des plafonds afin d’éviter les abus. Le dépassement de ces plafonds se traduit par des messages d’erreur indiquant qu’un trop grand nombre de requêtes a été créé en peu de temps. L’utilisation de stratégies de recul exponentielles peut permettre de ralentir la fréquence des requêtes une fois le plafond atteint.

Pour optimiser les performances et éviter d’atteindre les plafonds, créez un système de file d’attente pour les requêtes d’API. Cela permet de contrôler le rythme des requêtes et de garantir le respect des plafonds de l’API sans sacrifier les performances.

Stratégies de mise en cache

Procédez à une mise en cache des données fréquemment consultées, telles que les insights d’audience ou les indicateurs de performance publicitaire. Cela permet de réduire le nombre d’appels d’API, d’accélérer la récupération des données, mais surtout d’accroître l’efficacité de l’application.

Gestion des versions d’API

Restez informé·e des mises à jour et modifications apportées dans l’API Marketing en vérifiant régulièrement la documentation. Placer des appels d’API dans des fonctions spécifiques à la version peut préparer votre application aux modifications de version et permettre des mises à jour indépendantes.

Enregistrement et surveillance des erreurs

Mettez en place un système robuste de consignation des erreurs afin de suivre les interactions avec l’API. Cela permettra d’identifier les schémas d’erreur et d’accélérer les résolutions. L’utilisation d’outils de surveillance permet d’alerter les développeur·ses en cas de défaillances critiques ou de schémas inhabituels dans l’utilisation de l’API.