Clés API, appels API et questions à l'assistant IA

L'assistant IA et l'API sont disponibles dans toutes les offres, y compris Free. Leurs limites mensuelles dépendent de votre offre et sont partagées par toute l'organisation.

Questions à l'assistant IA

L'assistant répond aux questions sur vos données et sur le fonctionnement de StockBold. Ouvrez-le avec le bouton Aide en bas à droite de l'écran, puis sélectionnez Demander à l'assistant. Vous devez disposer de l'autorisation Use AI Assistant ; tous les rôles la possèdent, sauf Opérateur.

Chaque question à laquelle l'assistant répond est décomptée une fois du nombre de questions mensuelles de l'organisation. Une question qui échoue avec une erreur n'est pas décomptée.

Lorsqu'il reste moins d'un cinquième des questions du mois, l'assistant affiche le nombre restant, par exemple : Il vous reste 40 questions sur 200 ce mois-ci avec l'offre Starter. Lorsqu'elles sont épuisées, il l'indique, précise l'offre qui comprend davantage de questions et donne la date de réinitialisation. D'ici là, il ne répond plus à aucune question. Le décompte apparaît aussi dans Paramètres, puis Offre et facturation, sous Utilisation.

Lorsque 80 % des questions du mois ont été utilisées, les propriétaires reçoivent une alerte dans l'application et par e-mail, si leurs Alertes d'offre et d'utilisation sont activées dans Paramètres, puis Notifications.

Créer une clé API

Une clé API permet à un autre système de lire et de modifier vos données StockBold via l'API. Les clés sont créées dans Paramètres, puis API, qui apparaît pour le propriétaire et toute personne disposant de l'autorisation Manage API Keys. Le rôle Administrateur la possède.

1. Ouvrez Paramètres, puis API.
2. Sélectionnez Créer une clé API.
3. Saisissez un Nom pour pouvoir distinguer la clé ultérieurement.
4. Cochez les autorisations dont la clé a besoin. Vous ne pouvez accorder que les autorisations dont vous disposez vous-même.
5. Définissez éventuellement Expire le. La clé cesse de fonctionner à la fin de ce jour ; si le champ est vide, elle n'expire jamais.
6. Indiquez éventuellement les Adresses IP autorisées. Si le champ est vide, les requêtes provenant de toute adresse sont acceptées.
7. Créez la clé.
8. Copiez-la immédiatement. Elle n'est affichée qu'une seule fois.

Gérer les clés API

Pour chaque clé de la liste, vous pouvez modifier ses autorisations avec Modifier les autorisations, la remplacer avec Régénérer ou la révoquer avec Révoquer. Lorsque vous régénérez une clé, l'ancienne cesse immédiatement de fonctionner.

Le propriétaire voit aussi les clés des autres personnes et peut les révoquer, ou désactiver toutes les clés de l'organisation avec Tout révoquer. L'onglet Journal des requêtes répertorie les appels effectués avec les clés, et Documentation de l'API ouvre la documentation de référence pour la personne qui crée la connexion.

Le nombre de clés que l'organisation peut posséder dépend de l'offre. Lorsque la limite est atteinte, Créer une clé API est désactivé et Limite de clés API atteinte s'affiche au-dessus de la liste.

Appels API

Sur la même page, Utilisation de l'API ce mois-ci affiche les appels effectués ce mois-ci et la date de réinitialisation du décompte. Free et Starter comprennent un nombre défini d'appels par mois ; Pro et les offres supérieures n'ont pas de limite mensuelle.

Chaque offre limite également le nombre de requêtes par minute que l'organisation peut effectuer avec l'ensemble de ses clés. Ce nombre est indiqué sur la page.

Lorsque les appels du mois sont épuisés, les appels supplémentaires sont refusés jusqu'à la réinitialisation. Lorsque 80 % des appels ont été utilisés, les propriétaires et la personne qui a créé la clé reçoivent une alerte, si leurs Alertes d'offre et d'utilisation sont activées.