Saltar para o conteúdo
Verificado

Carregar um ficheiro para o Drive

A única chamada desta secção que não é um corpo JSON, um carregamento multipart para o Drive da própria conta.

Todas as outras chamadas desta secção enviam api_key e os seus campos como um único corpo JSON. upload_drive_file_user é a exceção: o próprio ficheiro tem de viajar como uma parte multipart, por isso api_key e os restantes campos seguem ao lado como campos de formulário em vez de JSON. O endpoint continua a ser /cpi/upload_drive_file_user, como qualquer outro método, o multer está montado à frente do router para todas as rotas e só atua quando o pedido é realmente multipart.

Método

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Este método não tem uma lista de campos declarada

upload_drive_file_user é um dos poucos métodos com um array fields vazio no registo (recebe um ficheiro, não parâmetros com tipos), por isso a referência interativa não lhe pode mostrar as entradas. São lidas diretamente do pedido pelo handler e reproduzidas a partir do código abaixo.

Passo a passo

Envie o ficheiro como multipart, não como JSON

A parte do ficheiro tem de se chamar file, esse é o único nome de campo que o multer está configurado para aceitar. Tudo o resto é um campo de formulário normal no mesmo pedido: api_key, um path opcional (a pasta onde o colocar, por omissão /), um booleano make_public opcional e um valor tags opcional (uma cadeia separada por vírgulas ou um array JSON).

curl -s https://xuda.ai/cpi/upload_drive_file_user \
  -F "api_key=YOUR_API_KEY" \
  -F "path=/Reports" \
  -F "tags=quarterly,finance" \
  -F "file=@/local/path/q3-report.pdf"
const form = new FormData();
form.append('api_key', 'YOUR_API_KEY');
form.append('path', '/Reports');
form.append('tags', 'quarterly,finance');
form.append('file', fileInput.files[0]); // a File/Blob, e.g. from an <input type="file">

const res = await fetch('https://xuda.ai/cpi/upload_drive_file_user', {
  method: 'POST',
  body: form, // no content-type header: the browser sets the multipart boundary itself
});
const { code, data } = await res.json();
if (code > 0) console.log(data.file_url);
import requests

with open('/local/path/q3-report.pdf', 'rb') as fh:
    res = requests.post(
        'https://xuda.ai/cpi/upload_drive_file_user',
        data={'api_key': 'YOUR_API_KEY', 'path': '/Reports', 'tags': 'quarterly,finance'},
        files={'file': ('q3-report.pdf', fh, 'application/pdf')},
    )
body = res.json()
if body['code'] > 0:
    print(body['data']['file_url'])

A resposta

json
{
  "code": 760,
  "data": {
    "server_file_name": "drv_app_5d9e21_a91f0eaa.pdf",
    "filename": "q3-report.pdf",
    "file_url": "https://xuda.ai/user-drive/app_5d9e21/drv_app_5d9e21_a91f0eaa.pdf",
    "file_path": "/Reports",
    "bucket": { "xuda.ai": { "Bucket": "...", "Key": "...", "Location": "..." } }
  },
  "rename": false
}

O sucesso responde code: 760, não o habitual 1, ramifique por code > 0, não por um valor específico. Uma colisão de nomes no mesmo caminho também não é um erro: o ficheiro é guardado com um server_file_name desambiguado e rename regressa true para que saiba que o nome original não foi o realmente usado. filename devolve sempre o nome original do carregamento.

Erros

Como este método não tem campos declarados, nenhum destes regressa com a habitual mensagem 'x' is a mandatory field, são o texto do próprio handler em data, todos com code: -400:

Uma api_key em falta ou sem autorização continua a falhar da forma normal, em -401, antes de o handler ser sequer alcançado. Consulte Erros.

A seguir