# Crear un token de API

Crea un token de API personal para scripts y herramientas como rclone, elige a qué puede acceder y revócalo cuando ya no lo necesites.

Actualizado: 2026-10-19  
Fuente: https://drime.cloud/es/support/integrations-and-api/api-tokens

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](https://docs.drime.cloud/authentication).

## 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**.

   ![Ajustes, Desarrolladores, con la sección Tokens de acceso a la API y el botón Crear un token](https://drime.cloud/media/01M5A9VZ3EXT7ZMZHRBK5B9MS0/7ada18a14def-web-settings-developers-tokens.png)

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](#permissions).

   ![El cuadro de diálogo Crear un nuevo token, con el nombre del token y las pestañas Permisos](https://drime.cloud/media/01M59T977CYEFV0EGJSEE6Y0F7/1767ae179cc0-web-settings-developers-token-dialog.png)

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 nuevo mostrado una sola vez, con el botón Copiar y el aviso de guardarlo en un lugar seguro](https://drime.cloud/media/01M5A9VVN2VHMPSB1CPTQWH2G4/45e6a99fae24-web-settings-developers-token-shown-once.png)

> **Importante**
>
> El token solo se muestra una vez: **Asegúrate de guardar el token en un lugar seguro. Una vez que se cierre este cuadro de diálogo, el token ya no se podrá ver.** Guárdalo enseguida en un gestor de contraseñas o en la configuración de tu herramienta. Si lo pierdes, elimínalo y crea uno nuevo.

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.

| Permiso | Qué puede hacer el token |
| --- | --- |
| **Todo** | Todo lo que tu cuenta puede hacer a través de la API. |
| **Solo lectura** | Leer todos los recursos de la lista de abajo, sin cambiar nada. |
| **Restringido** | Solo los recursos configurados en **Leídas** o **Escritura**. Todo lo que se queda en **Sin acceso** se rechaza. |

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](https://docs.drime.cloud/authentication) (en inglés). Para usar un token con rclone, consulta [Rclone, Drime CLI y WebDAV](https://drime.cloud/es/support/integrations-and-api/rclone-cli-and-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.

   ![El cuadro de confirmación ¿Eliminar el token?](https://drime.cloud/media/01M5A9VQDKFSB11N67Y0PAC592/fe208ec6869e-web-settings-developers-delete-token.png)

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](https://drime.cloud/es/support/account-and-settings/sessions-and-devices).

## Si no funciona

| Lo que ves | Qué hacer |
| --- | --- |
| **Tokens de acceso a la API** no aparece en **Desarrolladores** | El acceso a la API no está activado en tu cuenta. [Contacta con el soporte de Drime](https://drime.cloud/es/support/getting-started/contact-drime-support). |
| Has perdido el token | No se puede volver a mostrar. Elimínalo y crea uno nuevo. |
| **Crear** muestra un error debajo de **Nombre del token** | El nombre debe tener entre 3 y 100 caracteres. |
| `401` con `Unauthenticated.` | Falta el token, es incorrecto o se ha eliminado. Revisa el encabezado `Authorization: Bearer` o crea un token nuevo. |
| `403` con `This API key is missing the required scope: files.write` (u otro recurso) | El token es **Solo lectura** o **Restringido** y no tiene ese recurso. Crea un token con ese recurso configurado en **Leídas** o **Escritura** (el mensaje lo indica), o con **Todo**. |
| `403` con `This endpoint cannot be accessed with a restricted API key.` | Esta parte de la API, como los ajustes de la cuenta o de facturación, necesita un token **Todo**. |
| `403` con `This action is unauthorized.` | Es tu propia cuenta la que no tiene permiso para hacerlo, sea cual sea el token. |

## Próximos pasos

- [Rclone, Drime CLI y WebDAV](https://drime.cloud/es/support/integrations-and-api/rclone-cli-and-webdav)
- [Ver y cerrar las sesiones de tus dispositivos](https://drime.cloud/es/support/account-and-settings/sessions-and-devices)