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 sans exposer les clés API aux scripts exécutés.

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.
• Aviation Edge : utilisé dans les organisations qui activent des workflows ou agents liés aux données aéronautiques et disposent d’une clé organisation.

Modes d’identifiants

Ordalie distingue plusieurs modes d’accès selon le fournisseur et la configuration de votre organisation.

• Géré par Ordalie : la clé fournisseur est opérée par Ordalie. L’utilisateur peut activer ou désactiver l’usage si son compte y a accès.
• Clé personnelle : l’utilisateur renseigne sa propre clé fournisseur lorsque ce mode est disponible.
• Clé d’organisation : un administrateur configure la clé au niveau de l’organisation. Les autres membres peuvent utiliser l’API si elle est activée, sans voir la clé.

Qui peut les activer

Les APIs managées se contrôlent depuis Paramètres > Intégrations. Selon le fournisseur, l’activation peut dépendre de votre formule, de votre organisation et des droits administrateur. Les APIs en mode organisation sont configurées par les administrateurs, car elles peuvent avoir des implications de coût, de quota et de conformité.

Où elles sont utilisées

Le workflow de traduction de document peut utiliser DeepL pour créer une copie traduite tout en conservant 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. Aviation Edge peut être exposé aux agents et workflows autorisés pour interroger des données aéronautiques via une clé gérée par l’organisation.

Sécurité et limites

Les clés fournisseurs ne sont jamais transmises aux scripts ou au runtime agent. Les appels passent par le serveur Ordalie, avec politiques d’accès, quotas, validation des endpoints et cache lorsque c’est pertinent. Selon le fournisseur et la configuration de l’organisation, l’usage peut être désactivé, limité ou réservé à certains workflows.

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 Paramètres > Intégrations, que votre organisation l’autorise, que la clé requise est configurée et que le fournisseur n’est pas temporairement indisponible ou limité.