Autenticazione

Tutte le richieste API richiedono un token di accesso valido nell’header Authorization. viewneo supporta due metodi di autenticazione: Personal Access Token e OAuth2.

Personal Access Token

Il modo più semplice per autenticarsi. Generare un token nelle impostazioni del proprio account viewneo:

1. Andare su Impostazioni > API nel CMS

2. Fare clic su Genera nuovo token 3. Inserire una descrizione per identificare il token 4. Fare clic su Salva 5. Copiare il token immediatamente — viene visualizzato solo una volta

Utilizzare il token nelle proprie richieste API:

Authorization: Bearer YOUR_ACCESS_TOKEN

Attenzione

Trattare i personal access token come le password. Non condividerli mai e non includerli nel codice lato client. I token rimangono validi a tempo indeterminato fino alla rimozione manuale.

OAuth2

Per le applicazioni che agiscono per conto degli utenti, utilizzare il flusso del codice di autorizzazione OAuth2.

Passaggio 1: Creare un client OAuth

In Impostazioni > API, fare clic su Genera nuovo client e configurare:

• Descrizione — Un’etichetta visualizzata agli utenti durante l’autorizzazione
• URL di reindirizzamento — L’URL di callback dove viene inviato il codice di autorizzazione

Passaggio 2: Richiedere l’autorizzazione

Reindirizzare l’utente all’endpoint di autorizzazione:

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

Dopo che l’utente autorizza l’applicazione, viene reindirizzato all’URL di callback con un codice di autorizzazione:

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

Passaggio 3: Scambiare il codice per il token

Inviare una richiesta POST per ottenere il token di accesso:

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"
  }'

Risposta:

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

Passaggio 4: Aggiornare il token

Quando il token di accesso scade, utilizzare il refresh token per ottenerne uno nuovo:

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"
  }'

Utilizzo del token

Includere il token di accesso in tutte le richieste API:

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