{"id":1634,"date":"2017-12-18T11:14:21","date_gmt":"2017-12-18T11:14:21","guid":{"rendered":"http:\/\/www.portatour.com\/blog\/users\/?p=1634"},"modified":"2017-12-18T11:14:21","modified_gmt":"2017-12-18T11:14:21","slug":"lapi-envoie-des-notifications-par-e-mail","status":"publish","type":"post","link":"https:\/\/www.portatour.com\/blog\/users\/fr\/2017\/12\/18\/lapi-envoie-des-notifications-par-e-mail\/","title":{"rendered":"L’API envoie des notifications par e-mail lors des erreurs"},"content":{"rendered":"

Remarque: l’article suivant s’adresse principalement aux administrateurs portatour\u00ae des comptes entreprise (2 utilisateurs ou plus).<\/em><\/p>\n

Chez portatour\u00ae, nous sommes tr\u00e8s heureux que de nombreuses entreprises utilisent l’API de portatour\u00ae Anywhere pour importer et exporter automatiquement leurs donn\u00e9es de fa\u00e7on r\u00e9guli\u00e8re.<\/p>\n

Toutefois, dans le cadre des analyses de fichiers journaux, nous avons constat\u00e9 que dans certains cas, il y a un traitement insuffisant des causes des appels d’API erron\u00e9s. Cela signifie que les m\u00eames appels incorrects sont essay\u00e9s encore et encore jour apr\u00e8s jour.<\/p>\n

En raison de ces erreurs, qui sont souvent dues \u00e0 des incoh\u00e9rences de donn\u00e9es dans le fichier d’importation, les appels API \u00e9chouent compl\u00e8tement. Le repr\u00e9sentant itin\u00e9rant ne re\u00e7oit pas de donn\u00e9es actuelles. Souvent, le probl\u00e8me est identifi\u00e9 et corrig\u00e9 des jours ou semaines plus tard, seulement parce que les utilisateurs se plaignent.<\/p>\n

Par la mise \u00e0 jour d’aujourd’hui de l’API portatour\u00ae, nous publions une solution par laquelle de telles erreurs peuvent \u00eatre rapidement d\u00e9tect\u00e9es et r\u00e9solues avant que les utilisateurs ne soient affect\u00e9s.<\/p>\n

Quand un appel d’API \u00e9choue, portatour\u00ae envoie automatiquement un courriel avec une description exacte de l’appel et de l’erreur \u00e0 l’adresse du compte administrateur duquel les identifiants <\/span><\/span>ont \u00e9t\u00e9 utilis\u00e9s pour l’appel API. En tant qu’administrateur, vous pouvez rapidement commencer \u00e0 rem\u00e9dier \u00e0 la cause. Il est important de s’assurer que le compte d’administrateur que vous utilisez ait une adresse e-mail correcte et que la correspondance envoy\u00e9e \u00e0 ce compte est aussi r\u00e9guli\u00e8rement lue.<\/p>\n

Remarque: Pour \u00e9viter de g\u00e9n\u00e9rer une inondation de courriers \u00e9lectroniques pour les erreurs impliquant de nombreux comptes d’utilisateurs et donc de nombreux appels d’API, l’envoi d’e-mail automatique est toujours diff\u00e9r\u00e9e pour au moins une minute apr\u00e8s un appel d’API erron\u00e9. Si d’autres appels API incorrects se produisent pendant cette minute, tous les messages d’erreur sont combin\u00e9s dans un seul e-mail et l’envoi est de nouveau retard\u00e9. Par cons\u00e9quent, ne soyez pas \u00e9tonn\u00e9 lorsque les e-mails arrivent toujours au moins une minute plus tard en cas d’erreur.<\/em><\/p>\n

\u00c0 ce stade, nous aimerions vous rassurer: il s’agit g\u00e9n\u00e9ralement des cas particuliers dans les donn\u00e9es ou dans le processus qui \u00e9taient encore inconnus lors de la programmation initiale de la synchronisation de donn\u00e9es via l’API et qui doivent \u00eatre repr\u00e9sent\u00e9 dans dans votre code de programme ou processus. Les appels API doivent par la suite passer sans erreurs sur une base continue.<\/p>\n

L’envoi automatique des e-mails lors des erreurs ne peut pas \u00eatre d\u00e9sactiv\u00e9. La correction de la cause de toutes les erreurs doit toujours \u00eatre une priorit\u00e9, sinon les appels d’API \u00e9choueront de toute fa\u00e7on.<\/p>\n

Notez cependant que si les notifications de courrier \u00e9lectronique couvrent plusieurs des erreurs d’automatisation possibles, elles ne sont pas tout englobant. Par exemple, dans les deux sc\u00e9narios suivants, portatour\u00ae n’envoie pas d’e-mail:<\/p>\n