Saltar al contenido
Verificada

Subir un archivo a Drive

La única llamada de esta sección que no usa un cuerpo JSON, una subida multipart al Drive propio de la cuenta.

Todas las demás llamadas de esta sección envían api_key y sus campos como un único cuerpo JSON. upload_drive_file_user es la excepción: el archivo debe viajar como una parte multipart, así que api_key y el resto de los campos van junto a él como campos de formulario en lugar de JSON. El endpoint sigue siendo /cpi/upload_drive_file_user, igual que cualquier otro método; multer está montado antes del router en todas las rutas y solo actúa cuando la petición es realmente multipart.

Método

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Este método no tiene una lista de campos declarada

upload_drive_file_user es uno de los pocos métodos con un array fields vacío en el registro (recibe un archivo, no parámetros tipados), así que la referencia interactiva no puede mostrarte sus entradas. El manejador las lee directamente de la petición, y se reproducen más abajo a partir del código fuente.

Paso a paso

Envía el archivo como multipart, no como JSON

La parte del archivo debe llamarse file, el único nombre de campo que multer está configurado para aceptar. Todo lo demás son campos de formulario normales en la misma petición: api_key, un path opcional (la carpeta donde colocarlo, por defecto /), un booleano make_public opcional y un valor tags opcional (una cadena separada por comas o un 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'])

La respuesta

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
}

El éxito responde code: 760, no el habitual 1, así que ramifica según code > 0, no según un valor concreto. Una colisión de nombre en la misma ruta tampoco es un error: el archivo se guarda con un server_file_name desambiguado y rename vuelve en true para que sepas que no se usó el nombre original. filename siempre devuelve el nombre original de la subida.

Errores

Como este método no tiene campos declarados, ninguno de estos vuelve con el habitual mensaje 'x' is a mandatory field; son el texto propio del manejador en data, todos con code: -400:

Una api_key ausente o sin autorización sigue fallando de la forma normal, con -401, antes de llegar siquiera al manejador. Consulta Errores.

Siguiente