Authentifizierung

Alle API-Anfragen erfordern ein gültiges Zugriffstoken im Authorization-Header. viewneo unterstützt zwei Authentifizierungsmethoden: Personal Access Tokens und OAuth2.

Personal Access Token

Die einfachste Methode zur Authentifizierung. Generieren Sie ein Token in Ihren viewneo-Kontoeinstellungen:

1. Gehen Sie im CMS zu Einstellungen > API

2. Klicken Sie auf Neues Token generieren 3. Geben Sie eine Beschreibung ein, um das Token zu identifizieren 4. Klicken Sie auf Speichern 5. Kopieren Sie das Token sofort — es wird nur einmal angezeigt

Verwenden Sie das Token in Ihren API-Anfragen:

Authorization: Bearer YOUR_ACCESS_TOKEN

Achtung

Behandeln Sie Personal Access Tokens wie Passwörter. Teilen Sie sie niemals und fügen Sie sie nicht in clientseitigen Code ein. Tokens bleiben unbegrenzt gültig, bis sie manuell entfernt werden.

OAuth2

Für Anwendungen, die im Namen von Benutzern handeln, verwenden Sie den OAuth2-Authorization-Code-Flow.

Schritt 1: OAuth-Client erstellen

Klicken Sie unter Einstellungen > API auf Neuen Client generieren und konfigurieren Sie:

• Beschreibung — Ein Label, das Benutzern während der Autorisierung angezeigt wird
• Redirect-URL — Die Callback-URL, an die der Autorisierungscode gesendet wird

Schritt 2: Autorisierung anfordern

Leiten Sie den Benutzer zum Autorisierungsendpunkt weiter:

https://cloud.viewneo.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code

Nachdem der Benutzer Ihre Anwendung autorisiert hat, wird er mit einem Autorisierungscode zu Ihrer Callback-URL weitergeleitet:

https://example.com/callback?code=AUTHORIZATION_CODE

Schritt 3: Code gegen Token tauschen

Senden Sie eine POST-Anfrage, um das Zugriffstoken zu erhalten:

curl -X POST https://cloud.viewneo.com/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "authorization_code",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uri": "https://example.com/callback",
    "code": "AUTHORIZATION_CODE"
  }'

Antwort:

{
  "token_type": "Bearer",
  "expires_in": 1296000,
  "access_token": "YOUR_ACCESS_TOKEN",
  "refresh_token": "YOUR_REFRESH_TOKEN"
}

Schritt 4: Token erneuern

Wenn das Zugriffstoken abläuft, verwenden Sie das Refresh-Token, um ein neues zu erhalten:

curl -X POST https://cloud.viewneo.com/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "refresh_token",
    "refresh_token": "YOUR_REFRESH_TOKEN",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

Token verwenden

Fügen Sie das Zugriffstoken in alle API-Anfragen ein:

curl -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  'https://cloud.viewneo.com/api/v1.0/playlist'