Saltar para o conteúdo

Drive

Ficheiros, pastas e partilha, com armazenamento a que pode acrescentar.

Abrir Drive
Verificado com o painel em 18 de novembro de 2026

Tudo o que os ecrãs do Drive fazem com os seus ficheiros pode ser feito a partir de código. Cada ação tem um método cujo nome termina em _user, o que significa sempre o Drive da sua própria conta. As mesmas ações existem com terminações _workspace e _studio para o Drive de uma área de trabalho e para os ficheiros de construção do Studio: são outras superfícies, e a lista completa está no fim.

Cada chamada é um POST para /cpi/<method> com um corpo JSON que leva a sua chave de API:

bash
curl -X POST https://xuda.ai/cpi/get_drive_files_user \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_API_KEY","path":"/","sort_by":"date","sort_dir":"desc"}'

A resposta são as pastas e os ficheiros do caminho que pediu. Um ficheiro ou pasta é identificado pelo seu file_path e pelo seu type, que é file ou directory.

O que cada ecrã faz, como uma chamada

Mover para o Lixo é uma eliminação suave. Um ficheiro volta com restore_trashed_files_user até ser purgado. delete_drive_files_user elimina definitivamente sem passar pelo Lixo.

Trabalhar dentro de algo partilhado consigo

A maioria dos métodos _user recebe um share_id opcional. Dê o share_id de uma linha de Partilhado comigo e a chamada funciona no Drive de quem partilhou, ao nível que a partilha lhe dá, apenas no item partilhado ou dentro de uma pasta partilhada: Leitura lista e abre, Leitura e escrita também muda nomes, carrega e move lá dentro, Administrador também envia para o lixo, elimina e torna público.

Partilha

Com quem um ficheiro é partilhado não é um método do Drive. A janela de partilha de um ficheiro chama create_share e get_shares com access_type definido como user_drive e o caminho do ficheiro como share_item_id. share_level é read, readwrite ou admin.

Todos os métodos do Drive

Planos

Um carregamento não é recusado por falta de espaço. Veja Planos e faturação para saber o que conta para o seu espaço e o que acontece além dele.

Que tal está este guia?

Última atualização em 16 de novembro de 2026