Vai al contenuto
Verificata

Caricare un file su Drive

L'unica chiamata di questa sezione che non usa un corpo JSON, un caricamento multipart sul Drive dell'account.

Ogni altra chiamata di questa sezione invia api_key e i suoi campi in un unico corpo JSON. upload_drive_file_user è l'eccezione: il file stesso deve viaggiare come parte multipart, quindi api_key e gli altri campi lo accompagnano come campi del modulo invece che come JSON. L'endpoint è sempre /cpi/upload_drive_file_user, come per qualsiasi altro metodo: multer è montato prima del router su ogni route e agisce solo quando la richiesta è davvero multipart.

Metodo

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Questo metodo non ha un elenco di campi dichiarato

upload_drive_file_user è uno dei pochi metodi con un array fields vuoto nel registro (accetta un file, non parametri tipizzati), quindi il riferimento interattivo non può mostrarti i suoi input. Vengono letti direttamente dalla richiesta dal gestore e sono riportati qui sotto dal sorgente.

Procedura

Invia il file come multipart, non come JSON

La parte del file deve chiamarsi file, l'unico nome di campo che multer è configurato ad accettare. Tutto il resto è un normale campo del modulo nella stessa richiesta: api_key, un path facoltativo (la cartella in cui metterlo, di default /), un booleano make_public facoltativo e un valore tags facoltativo (una stringa separata da virgole 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 risposta

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
}

Il successo risponde code: 760, non il solito 1: ramifica su code > 0, non su un valore specifico. Nemmeno una collisione di nome nello stesso percorso è un errore: il file viene salvato con un server_file_name disambiguato e rename torna true, così sai che il nome originale non è quello effettivamente usato. filename riporta sempre il nome originale del caricamento.

Errori

Poiché questo metodo non ha campi dichiarati, nessuno di questi torna con il solito messaggio 'x' is a mandatory field: sono il testo del gestore stesso in data, tutti con code: -400:

Una api_key mancante o non autorizzata fallisce comunque nel modo normale, con -401, prima che il gestore venga raggiunto. Vedi Errori.

Passi successivi