---
title: "Authentifizierung"
source: /de/gcxone/api/authentication
locale: de
updated: 2026-09-04
---
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.

```json
{
  "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

```bash
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](/api-reference) ist dieselbe Spezifikation in Swagger UI, und [der Überblick](/gcxone/api/overview) 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`.