APIs managées

Les APIs gérées sont des services externes qu'Ordalie peut appeler pour vous, à l'aide d'identifiants que nous conservons côté serveur. Elles permettent à l'assistant et à vos workflows de s'appuyer sur des fournisseurs spécialisés, sans que les clés des fournisseurs ne soient jamais confiées aux scripts exécutés. Vous les retrouvez dans vos Paramètres personnels, sous l'onglet Intégrations, dans une section intitulée APIs gérées.

Les services disponibles aujourd'hui

Trois fournisseurs sont disponibles. DeepL prend en charge la traduction : c'est lui qu'utilise le workflow de traduction de document pour produire une copie traduite d'un fichier tout en laissant l'original inchangé. Pappers fournit des données officielles sur les entreprises françaises, comme les dirigeants, les dépôts, les comptes et les documents du registre, qu'une tâche peut récupérer lorsqu'elle en a besoin. Aviation Edge donne accès à des données aéronautiques ; il s'adresse aux agents et aux workflows personnalisés qui interrogent ces données, plutôt qu'à un workflow prêt à l'emploi livré avec Ordalie.

Comment les clés sont gérées

Chaque service fonctionne de l'une de deux manières. La plupart sont gérés par Ordalie, avec la mention Gérée par Ordalie : la clé est conservée sur notre serveur, et il vous suffit d'activer ou de désactiver le service. DeepL et Pappers fonctionnent ainsi et sont activés par défaut ; vous pouvez donc les utiliser immédiatement et les désactiver si vous le préférez. Aviation Edge utilise quant à lui une Clé de l'organisation : un administrateur la configure une fois pour toute l'organisation, et une fois en place, chacun peut utiliser le service sans jamais voir la clé. Aucun des services actuels ne vous demande de renseigner votre propre clé personnelle.

Les activer et les désactiver

Vous gérez ces services depuis l'onglet Intégrations de vos Paramètres. Chaque service disponible affiche un interrupteur indiquant Activée ou Désactivée. Les services gérés par Ordalie comme DeepL et Pappers sont activés au départ et peuvent être désactivés à tout moment. Un service à clé d'organisation comme Aviation Edge dépend de la configuration de sa clé par un administrateur, et la possibilité de l'utiliser peut aussi dépendre de votre formule et de vos droits.

Quelle que soit la façon dont un service est configuré, les clés des fournisseurs ne sont jamais montrées aux scripts exécutés ni à l'assistant. Chaque appel passe par le serveur d'Ordalie, où s'appliquent des règles d'accès, des quotas, des vérifications de requête et une mise en cache. Selon le fournisseur et la configuration de votre organisation, un service peut être désactivé, limité ou réservé à certains workflows.

Si quelque chose ne fonctionne pas

Si un workflow qui dépend d'une API gérée échoue ou est indisponible, vérifiez que le service est activé dans les Paramètres, sous Intégrations, qu'un service à clé d'organisation a bien sa clé configurée, et que le fournisseur n'est pas temporairement indisponible ou limité.