Authentifizierung

Jeder Endpunkt der Genesis API erwartet ein Token im auth-token Anforderungsheader. Eine Anfrage ohne Token liefert 401.

Ein Token erhalten

Tauschen Sie ein API‑Anmeldecredential gegen ein Token aus mit POST /proxy/apiToken. Das Credential wird pro Dienstleister ausgestellt, daher gibt die Anfrage den Anbieter an, für den das Token gelten soll.

{
  "serviceProviderId": "string (required)",
  "accessId": "string (required)",
  "clientSecret": "string (required)"
}

Das Credential‑accessId und clientSecret werden in der Genesis‑Plattform unter den Einstellungen des Dienstleisters ausgestellt. Bewahren Sie das Geheimnis auf Ihrem Server auf: Ein Token kann an einen Browser gesendet werden, das Credential, das es erzeugt, darf nicht gesendet werden.

Verwendung des Tokens

curl -H "auth-token: <token>" https://api.nxgen.cloud/api/v1/user/me

GET /user/me gibt das Konto zurück, dem das Token zugeordnet ist, was die schnellste Prüfung ist, ob ein Token funktioniert.

Anfragen aus der Dokumentation testen

Die interaktive Referenz unter /api-reference ist dieselbe Spezifikation in Swagger UI, und der Überblick listet jede Ressource auf. Drücken Sie Authorize, fügen Sie ein Token ein, und jede Ausprobieren panel sendet es als auth-token. Das Token bleibt in Ihrem Browser; die Anfragen gehen direkt von dort zu https://api.nxgen.cloud/api/v1.