Authentification et accès
Une clé identifie une intégration
Section intitulée « Une clé identifie une intégration »Un administrateur gère les clés API dans API & integrations. Une clé appartient à un groupe, pas à un employé. Vous pouvez créer plusieurs clés nommées, définir une date d’expiration ou une durée illimitée, remplacer une clé et la révoquer. Le secret complet n’est affiché qu’une fois ; l’interface ne montre ensuite que son préfixe et ses informations d’utilisation. Conservez-le dans un gestionnaire de secrets côté serveur, jamais dans un navigateur ou une application mobile.
Envoyez la clé avec chaque requête à l’API publique :
Authorization: Bearer YOUR_API_KEYDans le champ Bearer Token de Scalar, collez uniquement la clé. Scalar ajoute automatiquement Bearer dans l’en-tête HTTP. Ne collez pas un second préfixe Bearer dans ce champ.
Le partenaire n’effectue pas de connexion pour obtenir un jeton d’accès ou de rafraîchissement. TrakarIA vérifie la clé, ses permissions, l’état de l’organisation et les droits commerciaux. Une clé révoquée ou expirée ne peut plus servir aux requêtes suivantes. Utilisez des clés distinctes pour vos différents logiciels afin de pouvoir les renouveler séparément.
Le lien d’inspection nécessite une personne connectée
Section intitulée « Le lien d’inspection nécessite une personne connectée »La clé API authentifie votre logiciel. Le lien de lancement désigne l’inspection à ouvrir, mais le collaborateur doit aussi se connecter à l’interface TrakarIA. Ne placez jamais la clé API dans le lien. Ces liens expirent rapidement et peuvent être renouvelés via l’API.
Adresse de l’API
Section intitulée « Adresse de l’API »Envoyez les requêtes vers https://api.trakaria.com. GET /v1/capabilities indique les fonctionnalités et limites applicables à une clé valide. Vous pouvez commencer par une requête en lecture seule avant de créer des dossiers dans votre compte.