Passer au contenu principal
Les clés Primo API sont utilisées pour authentifier les demandes adressées au Primo REST API. Il existe deux types de clés API, chacune avec une portée différente.

​
Types de clés API

​
Clé API Entreprise

Une clé API Entreprise est limitée à une seule entreprise. Elle donne accès à tous les endpoints qui opèrent sur les ressources au niveau de l’entreprise — appareils, employés, accessoires, tickets, SaaS, etc.

​
Clé API Workspace

Une clé API Workspace est limitée à l’ensemble de votre espace de travail. Elle donne accès aux endpoints au niveau du workspace, tels que la liste et la consultation des entreprises au sein de votre workspace.
La plupart des endpoints API nécessitent une clé API Entreprise. Seuls les endpoints spécifiques au workspace (sous /workspace/) nécessitent une clé API Workspace. Consultez la référence API pour le badge sur chaque endpoint.

​
Générer une clé API Entreprise

  1. Accédez à Paramètres > API.
  2. Cliquez sur Créer une clé API.
  3. Donnez un nom à la clé (par exemple “Mon intégration”).
  4. Cliquez sur Créer.
  5. Copiez la clé immédiatement – ​​elle ne sera plus affichée.
Conservez votre clé API en toute sécurité. Toute personne disposant de cette clé peut accéder à vos données Primo via le API.

​
Utilisez la clé API

Passez la clé dans l’entête Authorization de vos requêtes : 
curl https://api.getprimo.com/v1/devices \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Révoquer une clé

Pour révoquer une clé, accédez à Paramètres > API, recherchez la clé et cliquez sur Supprimer. Vous pouvez également supprimer une clé API révoquée.