Crear un token de API

Un token de API permite que un script o una herramienta, como rclone, acceda a tu cuenta de Drime sin tu contraseña. Tú eliges qué puede hacer cada token y puedes revocarlo en cualquier momento.

Los tokens personales son para tus propios scripts, copias de seguridad y herramientas, y actúan sobre tu cuenta. Una aplicación que otros usuarios de Drime conectan a sus cuentas usa OAuth y nunca debe pedirles su contraseña: consulta la documentación de la API de Drime.

#Crear un token

1. Haz clic en tu avatar, arriba a la derecha, y luego en Ajustes.

2. Haz clic en Desarrolladores.

3. En Tokens de acceso a la API, haz clic en Crear un token.

   

4. En Nombre del token, ponle al token un nombre que reconozcas.

   Indica la herramienta o el ordenador que lo usa, por ejemplo «rclone en mi NAS». El nombre debe tener entre 3 y 100 caracteres.

5. En Permisos, elige qué puede hacer el token.

   • Todo: acceso completo a todos los recursos.

   • Solo lectura: acceso de solo lectura a todos los recursos.

   • Restringido: acceso solo a los recursos que elijas, cada uno configurado en Sin acceso, Leídas (lectura) o Escritura.

   Consulta Elegir los permisos adecuados.

   

6. Haz clic en Crear.

7. Haz clic en Copiar para copiar el token y luego en Hecho.

   El botón muestra ¡Copiado! cuando el token está en el portapapeles.

   

El token aparece entonces en Tokens de acceso a la API y funciona de inmediato. No caduca: funciona hasta que lo eliminas.

#Elegir los permisos adecuados

Da a cada token solo lo que necesita.

Un token Restringido muestra estos recursos: Archivos (incluidas las versiones y la papelera), Carpetas, Uso compartido, Espacios de trabajo, Vault, Firmar, Pizarras, Solicitudes de archivos, Send & Track, Contactos, Etiquetas y Analíticas. Analíticas (el almacenamiento usado) solo se puede leer, así que sus opciones son Sin acceso y Acceso. Pasa el cursor sobre el icono de ayuda junto a un recurso para ver qué incluye.

Solo un token Todo puede acceder a los ajustes de tu cuenta, de seguridad y de facturación. Los tokens Solo lectura y Restringido nunca pueden.

Los permisos de un token no se pueden cambiar después de crearlo. Para cambiarlos, crea un token nuevo con los permisos adecuados, actualiza tu herramienta y luego elimina el token antiguo.

#Usar el token

Envía el token en el encabezado Authorization de cada solicitud:

Authorization: Bearer YOUR_ACCESS_TOKEN

El enlace Documentación junto a Tokens de acceso a la API abre la documentación de la API de Drime (en inglés). Para usar un token con rclone, consulta Rclone, Drime CLI y WebDAV.

#Ver y eliminar tus tokens

Tokens de acceso a la API muestra los tokens que has creado y los que las aplicaciones de Drime crean para sí mismas: Drime Desktop, Drime Mobile y la extensión del navegador. Cada fila muestra:

• el nombre del token, o la aplicación y su plataforma, por ejemplo Aplicación de escritorio · Windows;

• su permiso, por ejemplo Acceso completo;

• cuándo se usó por última vez, o Nunca usado.

Si no tienes ninguno, la sección muestra Aún no tienes ningún token de acceso personal.

Para revocar un token:

1. Haz clic en Eliminar el token (el icono de la papelera) al final de su fila.

   

2. Haz clic en Eliminar para confirmar.

   El cuadro de diálogo avisa: Este token se eliminará de forma inmediata y permanente. Una vez eliminado, ya no se podrá usar para realizar solicitudes a la API. Aparece Token eliminado y cualquier herramienta que use ese token deja de funcionar al instante.

También puedes cerrar la sesión de las aplicaciones de Drime desde Ver y cerrar las sesiones de tus dispositivos.

#Si no funciona

#Próximos pasos

• Rclone, Drime CLI y WebDAV

• Ver y cerrar las sesiones de tus dispositivos