Einstellungen

API-Keys

Zugangsdaten für die Plattform-API: die Key-Liste, Scopes, Ablaufdaten und der Gateway-Endpoint.

API-Keys sind die Zugangsdaten Ihrer Integrationen — der ERP-Sync, der BI-Export, das Skript, das Ihr Partner nachts laufen lässt. Jeder Key ist eine Tür in Ihre Daten; diese Liste zeigt, wie viele Türen es gibt.

Wo Sie es finden

Einstellungen › Developer › API-Keys/settings/api-keys.

Wozu es dient

Eine Zeile pro Key, mit Name und Prefix, den Scopes sowie Erstellungs- und Ablaufdatum. Der Block API-Gateway-Konfiguration zeigt den Gateway-Endpoint (https://api.revenexx.com) mit Kopieren-Button — die Basis-URL, gegen die jeder Key verwendet wird.

Der vollständige Wert eines Keys wird genau einmal angezeigt, beim Erstellen, und danach nie wieder; die Liste zeigt nur den Prefix (rvxk_…). Ist ein Wert verloren, ist die Antwort ein neuer Key, kein Support-Ticket.

Felder und Bedienelemente

Spalte / ElementInhalt oder Funktion
Name / PrefixDas Label des Keys und sein rvxk_…-Prefix.
ScopesWorauf der Key zugreifen darf; * heißt alles.
Erstellt / Läuft abDie Lebensdauer des Keys.
Zeilenmenü (…)Aktionen je Key.
API-Key erstellenLegt einen neuen Key an.
Endpoint kopierenKopiert die Gateway-URL.
Suche, AnsichtÜbliche Listenbedienung.

Was eine Änderung bewirkt

Ein neuer Key funktioniert sofort gegen den Gateway-Endpoint. Das Widerrufen eines Keys kappt alles, was ihn benutzt hat — finden Sie vorher heraus, was das ist, denn „der ERP-Sync stand um 02:00" ist die übliche Art, wie ein unangekündigter Widerruf auffällt.

Keys mit Scope * können alles, was die API kann. Während der Integration ist das bequem; vor dem Go-live lohnt es sich, die Scopes einzugrenzen.

Berechtigungen

Welche Cockpit-Rollen Keys erstellen oder widerrufen dürfen, ist nicht verifiziert. Der vollständige Key-Wert ist nach dem Erstellen für niemanden mehr abrufbar.

Verwandte Themen