Ihre API-Schlüssel

Einen Schlüssel erstellen

1. Öffnen Sie Ihren Avatar › API-Schlüssel und wählen Sie Neuer API-Schlüssel.
2. Benennen Sie ihn nach dem, was ihn nutzt, zum Beispiel Ihrem Reporting-Tool.
3. Wählen Sie Nur lesen oder Lesen und ändern.
4. Kopieren Sie ihn jetzt: Der Schlüssel wird nur einmal angezeigt.

Was ein Schlüssel darf

Ein Schlüssel darf, was Sie in diesem Workspace dürfen, und nicht mehr: Der Schlüssel eines Owners sieht alles, der eines Partner-Managers seine eigenen Partner, der eines Partners nur dessen eigene Zahlen. Er tut nie, was nur eine angemeldete Person tun darf, etwa Schlüssel, Passwörter oder das Team verwalten.

Jede Änderung mit einem Schlüssel trägt im Aktivitätsprotokoll seinen Namen, zum Beispiel „API-Schlüssel «BI» (erstellt von Maria)“, damit Sie immer wissen, was über die API kam.

Ihn verwenden

Senden Sie ihn bei jedem Aufruf an die Adresse Ihres Workspaces, in x-api-key oder als Authorization: Bearer. Die Aufrufe stehen in Die API-Referenz.

Gut zu wissen

• Der HitCTRL-Tarif Ihres Workspaces entscheidet, ob Schlüssel funktionieren und wie viele Aufrufe pro Minute sie machen dürfen. Über dem Limit lautet die Antwort 429 mit Retry-After.
• Widerrufen Sie einen Schlüssel, den Sie nicht mehr nutzen: Er stoppt sofort und bleibt aufgeführt, damit seine Änderungen seinen Namen behalten.
• Tracking-Aufrufe Ihres Servers nutzen die eigenen Schlüssel des Workspaces: siehe API-Schlüssel.