# Criar um token de API

Crie um token de API pessoal para scripts e ferramentas como o rclone, escolha o que ele pode acessar e revogue-o quando não precisar mais dele.

Atualizado em: 2026-10-19  
Fonte: https://drime.cloud/pt-br/support/integrations-and-api/api-tokens

Um token de API permite que um script ou uma ferramenta, como o rclone, acesse sua conta do Drime sem a sua senha. Você escolhe o que cada token pode fazer e pode revogá-lo a qualquer momento.

Os tokens pessoais servem para seus próprios scripts, backups e ferramentas, e funcionam na sua própria conta. Um aplicativo que outros usuários do Drime conectam às contas deles usa OAuth, e nunca deve pedir a senha dessas pessoas: consulte a [documentação da API do Drime](https://docs.drime.cloud/authentication).

## Criar um token

1. No canto superior direito, clique no seu avatar e depois em **Configurações**.

2. Clique em **Desenvolvedores**.

3. Em **Tokens de acesso à API**, clique em **Criar um token**.

   ![Configurações, Desenvolvedores, com a seção Tokens de acesso à API e o botão Criar um token](https://drime.cloud/media/01M5A9VZ3EXT7ZMZHRBK5B9MS0/7ada18a14def-web-settings-developers-tokens.png)

4. Em **Nome do token**, dê ao token um nome fácil de reconhecer.

   Indique a ferramenta ou o computador que vai usá-lo, por exemplo “rclone no meu NAS”. O nome precisa ter de 3 a 100 caracteres.

5. Em **Permissões**, escolha o que o token pode fazer.

   - **Tudo**: acesso completo a todos os recursos.
   - **Somente leitura**: acesso somente leitura a todos os recursos.
   - **Restrito**: acesso apenas aos recursos que você escolher, cada um definido como **Sem acesso**, **Lidas** (leitura) ou **Escrita**.

   Consulte [Escolher as permissões certas](#permissions).

   ![A caixa de diálogo de criação de token, com um nome de token e as abas de Permissões](https://drime.cloud/media/01M59T977CYEFV0EGJSEE6Y0F7/1767ae179cc0-web-settings-developers-token-dialog.png)

6. Clique em **Criar**.

7. Clique em **Copiar** para copiar o token e depois em **Pronto**.

   O botão mostra **Copiado!** quando o token está na sua área de transferência.

   ![O novo token exibido uma única vez, com o botão Copiar e o aviso para guardá-lo em um lugar seguro](https://drime.cloud/media/01M5A9VVN2VHMPSB1CPTQWH2G4/45e6a99fae24-web-settings-developers-token-shown-once.png)

> **Importante**
>
> O token aparece uma única vez: **Guarde o token em um lugar seguro. Depois que esta caixa de diálogo for fechada, o token não poderá mais ser visto.** Guarde-o na mesma hora em um gerenciador de senhas ou na configuração da sua ferramenta. Se você perdê-lo, exclua-o e crie um novo.

O token aparece então em **Tokens de acesso à API** e já funciona. Ele não expira: funciona até você excluí-lo.

## Escolher as permissões certas

Dê a um token apenas o que ele precisa.

| Permissão | O que o token pode fazer |
| --- | --- |
| **Tudo** | Tudo o que a sua conta pode fazer pela API. |
| **Somente leitura** | Ler todos os recursos listados abaixo, sem alterar nada. |
| **Restrito** | Apenas os recursos que você definir como **Lidas** ou **Escrita**. Tudo o que ficar em **Sem acesso** é recusado. |

Um token **Restrito** lista estes recursos: **Arquivos** (incluindo versões e lixeira), **Pastas**, **Compartilhamento**, **Espaços de trabalho**, **Vault**, **Assinar**, **Quadros brancos**, **Solicitações de arquivos**, **Send & Track**, **Contatos**, **Tags** e **Análises**. O recurso **Análises** (uso do armazenamento) só pode ser lido, por isso as opções são **Sem acesso** e **Acesso**. Passe o mouse sobre o ícone de ajuda ao lado de um recurso para ver o que ele abrange.

Só um token **Tudo** consegue acessar as configurações da sua conta, de segurança e de faturamento. Os tokens **Somente leitura** e **Restrito** nunca conseguem.

As permissões de um token não podem ser alteradas depois que ele é criado. Para mudá-las, crie um novo token com as permissões certas, atualize sua ferramenta e depois exclua o token antigo.

## Usar o token

Envie o token no cabeçalho `Authorization` de cada requisição:

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

O link **Documentação**, ao lado de **Tokens de acesso à API**, abre a [documentação da API do Drime](https://docs.drime.cloud/authentication). Para usar um token com o rclone, consulte [Rclone, Drime CLI e WebDAV](https://drime.cloud/pt-br/support/integrations-and-api/rclone-cli-and-webdav).

## Ver e excluir seus tokens

**Tokens de acesso à API** lista os tokens que você criou e os que os aplicativos do Drime criam para si mesmos: Drime Desktop, Drime Mobile e a extensão para navegador. Cada linha mostra:

- o nome do token, ou o aplicativo e a plataforma dele, por exemplo **Aplicativo para computador · Windows**;
- a permissão dele, por exemplo **Acesso completo**;
- quando ele foi usado pela última vez, ou **Nunca usado**.

Se você não tiver nenhum, a seção mostra **Você ainda não tem nenhum token de acesso pessoal**.

Para revogar um token:

1. Clique em **Excluir o token** (o ícone de lixeira) no fim da linha dele.

   ![A caixa de diálogo de confirmação Excluir o token?](https://drime.cloud/media/01M5A9VQDKFSB11N67Y0PAC592/fe208ec6869e-web-settings-developers-delete-token.png)

2. Clique em **Excluir** para confirmar.

   A caixa de diálogo avisa: **Este token será excluído de forma imediata e permanente. Depois de excluído, ele não poderá mais ser usado para fazer requisições à API.** Aparece **Token excluído**, e qualquer ferramenta que use esse token para de funcionar na mesma hora.

Você também pode desconectar os aplicativos do Drime em [Ver suas sessões e dispositivos e desconectá-los](https://drime.cloud/pt-br/support/account-and-settings/sessions-and-devices).

## Se não funcionar

| O que aparece | O que fazer |
| --- | --- |
| **Tokens de acesso à API** não está em **Desenvolvedores** | O acesso à API não está ativado na sua conta. Consulte [Falar com o suporte do Drime](https://drime.cloud/pt-br/support/getting-started/contact-drime-support). |
| Você perdeu o token | Ele não pode ser exibido de novo. Exclua-o e crie um novo. |
| **Criar** mostra um erro abaixo de **Nome do token** | O nome precisa ter de 3 a 100 caracteres. |
| `401` com `Unauthenticated.` | O token está ausente, incorreto ou foi excluído. Verifique o cabeçalho `Authorization: Bearer` ou crie um novo token. |
| `403` com `This API key is missing the required scope: files.write` (ou outro recurso) | O token é **Somente leitura** ou **Restrito** e não tem esse recurso. Crie um token com esse recurso definido como **Lidas** ou **Escrita** (a mensagem indica qual é), ou com **Tudo**. |
| `403` com `This endpoint cannot be accessed with a restricted API key.` | Essa parte da API, como as configurações da conta ou de faturamento, exige um token **Tudo**. |
| `403` com `This action is unauthorized.` | A sua própria conta não tem permissão para fazer isso, seja qual for o token. |

## Próximos passos

- [Rclone, Drime CLI e WebDAV](https://drime.cloud/pt-br/support/integrations-and-api/rclone-cli-and-webdav)
- [Ver suas sessões e dispositivos e desconectá-los](https://drime.cloud/pt-br/support/account-and-settings/sessions-and-devices)