Autenticación

Todas las solicitudes a la API requieren un token de acceso válido en el encabezado Authorization. viewneo admite dos métodos de autenticación: Personal Access Tokens y OAuth2.

Personal Access Token

La forma más sencilla de autenticarse. Genere un token en los ajustes de su cuenta viewneo:

1. Vaya a Settings > API en el CMS

2. Haga clic en Generate new token 3. Introduzca una descripción para identificar el token 4. Haga clic en Save 5. Copie el token inmediatamente — solo se muestra una vez

Utilice el token en sus solicitudes a la API:

Authorization: Bearer YOUR_ACCESS_TOKEN

Precaución

Trate los tokens de acceso personal como contraseñas. Nunca los comparta ni los incluya en código del lado del cliente. Los tokens permanecen válidos indefinidamente hasta que se eliminan manualmente.

OAuth2

Para aplicaciones que actúan en nombre de los usuarios, utilice el flujo de código de autorización OAuth2.

Paso 1: Crear un cliente OAuth

En Settings > API, haga clic en Generate new client y configure:

• Description — Una etiqueta que se muestra a los usuarios durante la autorización
• Redirect URL — La URL de callback donde se envía el código de autorización

Paso 2: Solicitar autorización

Redirija al usuario al endpoint de autorización:

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

Después de que el usuario autorice su aplicación, se le redirige a su URL de callback con un código de autorización:

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

Paso 3: Intercambiar el código por un token

Envíe una solicitud POST para obtener el token de acceso:

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

Respuesta:

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

Paso 4: Renovar el token

Cuando el token de acceso expire, utilice el refresh token para obtener uno nuevo:

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

Usar el token

Incluya el token de acceso en todas las solicitudes a la API:

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