Criar um token de API

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.

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

   

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.

   

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

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. Para usar um token com o rclone, consulte Rclone, Drime CLI e 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.

   

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.

#Se não funcionar

#Próximos passos

• Rclone, Drime CLI e WebDAV

• Ver suas sessões e dispositivos e desconectá-los