APIs managées

Les APIs managées sont des services externes qu’Ordalie peut appeler avec des identifiants gérés côté serveur. Elles permettent à l’assistant et aux workflows d’utiliser des fournisseurs spécialisés comme DeepL ou Pappers sans demander à chaque utilisateur d’apporter et d’exposer sa propre clé API.

APIs disponibles

• DeepL : utilisé pour les workflows de traduction de document et d’autres tâches de traduction lorsque l’API est activée.
• Pappers : utilisé pour récupérer des informations officielles sur les entreprises françaises lorsque la fonctionnalité est disponible.

Qui peut les activer

Les APIs managées se contrôlent depuis les paramètres et peuvent dépendre de votre formule, de votre organisation et de la configuration administrateur. Dans une organisation, les administrateurs peuvent décider quelles APIs managées sont disponibles, car leur usage peut avoir des implications de coût, de quota et de conformité.

Où elles sont utilisées

L’exemple le plus clair est le workflow de traduction de document : Ordalie envoie le contenu nécessaire au fournisseur de traduction managé, crée une copie traduite et conserve le document original inchangé. Les recherches d’informations sur les entreprises peuvent utiliser Pappers pour récupérer des données officielles lorsque la tâche le justifie.

Sécurité et limites

La clé du fournisseur externe est détenue par Ordalie, pas par l’utilisateur final. Les requêtes sont limitées et encadrées par les politiques fournisseur d’Ordalie. Selon le fournisseur et la configuration de l’organisation, l’usage peut être désactivé, limité ou mis en cache. Une API managée ne doit être utilisée que lorsque la tâche nécessite réellement ce service externe.

Dépannage

Si un workflow dépendant d’une API managée est indisponible ou échoue, vérifiez que l’API est activée dans les paramètres, que votre organisation l’autorise, et que le fournisseur n’est pas temporairement indisponible ou limité.