Zum Hauptinhalt springen
Primo API-Schlüssel werden zur Authentifizierung von Anforderungen an den Primo REST API verwendet. Es gibt zwei Arten von API-Schlüsseln, jeweils mit einem unterschiedlichen Geltungsbereich.

​
Arten von API-Schlüsseln

​
Unternehmens-API-Schlüssel

Ein Unternehmens-API-Schlüssel ist auf ein einzelnes Unternehmen beschränkt. Er gewährt Zugriff auf alle Endpunkte, die auf Unternehmensressourcen zugreifen — Geräte, Mitarbeiter, Zubehör, Tickets, SaaS und mehr.

​
Workspace-API-Schlüssel

Ein Workspace-API-Schlüssel ist auf Ihren gesamten Arbeitsbereich beschränkt. Er gewährt Zugriff auf Workspace-spezifische Endpunkte, wie das Auflisten und Anzeigen der Unternehmen in Ihrem Workspace.
Die meisten API-Endpunkte erfordern einen Unternehmens-API-Schlüssel. Nur die workspace-spezifischen Endpunkte (unter /workspace/) erfordern einen Workspace-API-Schlüssel. Prüfen Sie die API-Referenz für das Badge bei jedem Endpunkt.

​
Generieren Sie einen Unternehmens-API-Schlüssel

  1. Gehen Sie zu Einstellungen > API.
  2. Klicken Sie auf API-Schlüssel erstellen.
  3. Geben Sie dem Schlüssel einen Namen (z. B. „Meine Integration”).
  4. Klicken Sie auf Erstellen.
  5. Kopieren Sie den Schlüssel sofort – er wird nicht mehr angezeigt.
Bewahren Sie Ihren API-Schlüssel sicher auf. Jeder mit diesem Schlüssel kann über API auf Ihre Primo-Daten zugreifen.

​
Verwenden Sie den Schlüssel API

Übergeben Sie den Schlüssel im Authorization-Header Ihrer Anfragen: 
curl https://api.getprimo.com/v1/devices \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Einen Schlüssel widerrufen

Um einen Schlüssel zu widerrufen, gehen Sie zu Einstellungen > API, suchen Sie den Schlüssel und klicken Sie auf Löschen. Sie können auch einen widerrufenen API-Schlüssel löschen.