Gå til indhold
Bekræftet

Upload en fil til Drev

Det ene kald i dette afsnit, der ikke er en JSON-brødtekst, en multipart-upload til kontoens eget Drev.

Hvert andet kald i dette afsnit sender api_key og sine felter som én JSON-brødtekst. upload_drive_file_user er undtagelsen: selve filen skal rejse som en multipart-del, så api_key og resten af felterne følger med som formularfelter i stedet for JSON. Endpointet er stadig /cpi/upload_drive_file_user, ligesom enhver anden metode, multer er monteret foran routeren for hver rute og træder kun i kraft, når forespørgslen faktisk er multipart.

Metode

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Denne metode har ingen erklæret feltliste

upload_drive_file_user er en af de få metoder med et tomt fields-array i registret (den tager en fil, ikke typede parametre), så den interaktive reference kan ikke vise dig dens input. De læses direkte fra forespørgslen af handleren og er gengivet nedenfor fra kildekoden.

Gennemgang

Send filen som multipart, ikke JSON

Fildelen skal hedde file, det er det eneste feltnavn, multer er konfigureret til at acceptere. Alt andet er almindelige formularfelter i den samme forespørgsel: api_key, en valgfri path (den mappe, den skal placeres i, standard er /), en valgfri make_public-boolean og en valgfri tags- værdi (en kommasepareret streng eller et JSON-array).

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'])

Svaret

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
}

Succes svarer code: 760, ikke den sædvanlige 1, så forgren på code > 0, ikke på en bestemt værdi. En navnekollision på den samme sti er heller ikke en fejl: filen gemmes under et entydigt gjort server_file_name, og rename kommer tilbage som true, så du ved, at det oprindelige navn ikke var det, der faktisk blev brugt. filename gengiver altid det oprindelige upload-navn uanset hvad.

Fejl

Fordi denne metode ingen erklærede felter har, kommer ingen af disse tilbage som den sædvanlige besked 'x' is a mandatory field, de er handlerens egen tekst i data, alle ved code: -400:

En manglende eller uautoriseret api_key fejler stadig på den normale måde, ved -401, før handleren overhovedet nås. Se Fejl.

Næste