Cómo generar un token de acceso personal

Cada solicitud a la API de Vimeo requiere un token de autenticación. El token de autenticación nos dice quién realiza la solicitud y qué acciones puede realizar ese usuario. En este artículo se explica cómo generar un token de autenticación para la API de Vimeo.

En este artículo:

• Qué debe saber antes de generar un token de acceso personal
• Cómo generar un token de acceso personal
• Próximos pasos sugeridos

Qué debe saber antes de generar un token de acceso personal

• Para comenzar, deberá crear una aplicación API en nuestro Portal de Desarrolladores. Esto es lo que interactúa con la API y solicita autenticación. Aprenda a crear una en Cómo crear una aplicación API
• Un token de acceso personal es un código único que se utiliza para autenticar sus solicitudes a la API. 
• Este token puede ser "Autenticado", lo que significa que está asociado con su cuenta de Vimeo y puede acceder a los metadatos privados de su cuenta y de sus videos, o "No autenticado", lo que significa que solo está autorizado para su aplicación API y solo se puede utilizar para leer los metadatos que es público en Vimeo.com. 
• Si necesita que otros usuarios le otorguen acceso a su aplicación a sus cuentas de Vimeo, se debe generar un token de acceso mediante uno de nuestros otros flujos de trabajo de autenticación disponibles. 
  • La documentación completa sobre nuestros flujos de trabajo de autenticación está disponible en nuestro sitio para desarrolladores en "Trabajo con autenticación". 
• Mantenga su token seguro. Cualquier persona con acceso puede usarlo para realizar solicitudes en nombre de su aplicación o cuenta.

Cómo generar un token de acceso personal

Puede generar un token de acceso personal desde su página de aplicaciones en Vimeo. Para ello: 

1. Visite su página de aplicaciones.
2. Seleccione la aplicación con la que desea autenticarse o cree una aplicación si aún no lo ha hecho.
3. Seleccione Generar token de acceso en la columna de navegación de la izquierda, debajo del encabezado Autenticación. 
   
4. Seleccione Autenticado (usted) si necesita interactuar con datos privados de su cuenta. Seleccione Sin autenticar si solo necesita leer metadatos públicos.

5. Si selecciona Autenticado, en el encabezado Ámbitos, marque las capacidades que desea otorgar al token. Puede encontrar las definiciones de estos ámbitos en nuestro sitio para desarrolladores. 
   • ⚠️Nota: Para acceder a los videos no públicos o a los metadatos no públicos, debe seleccionar el alcance "privado", además de cualquier otro alcance que necesite. Si elige solo 'público', no podrá acceder a la información privada.
   • ai — Habilita el acceso a los puntos finales de la API de IA de Vimeo (transcripción, traducción de subtítulos, doblaje de audio, AskAI). Requerido para usuarios de Enterprise que deseen desencadenar acciones de IA mediante programación.
     
6. Seleccione Generar. La página se volverá a cargar y el token aparecerá claro en la sección Tokens de acceso personal.
7. Copie la cadena del token y guárdela en un lugar seguro. Este token se puede utilizar en sus guiones o aplicaciones para interactuar con la API de Vimeo.

Próximos pasos sugeridos

Visite nuestra documentación para desarrolladores para obtener más información sobre cómo trabajar con la autenticación.