Naar de inhoud springen
Geverifieerd

Een bestand uploaden naar Drive

De enige aanroep in deze sectie zonder JSON-body: een multipart-upload naar de eigen Drive van het account.

Elke andere aanroep in deze sectie stuurt api_key en zijn velden als één JSON-body. upload_drive_file_user is de uitzondering: het bestand zelf moet als multipart-onderdeel mee, dus api_key en de rest van de velden reizen er als formuliervelden naast mee in plaats van als JSON. Het endpoint blijft /cpi/upload_drive_file_user, zoals elke andere methode: multer staat voor elke route vóór de router en doet alleen iets als het verzoek echt multipart is.

Methode

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Deze methode heeft geen gedeclareerde veldenlijst

upload_drive_file_user is een van de weinige methoden met een lege array fields in het register (hij neemt een bestand, geen getypeerde parameters), dus de interactieve referentie kan zijn input niet tonen. De handler leest ze rechtstreeks uit het verzoek, en hieronder staan ze uit de broncode overgenomen.

Stappenplan

Stuur het bestand als multipart, niet als JSON

Het bestandsonderdeel moet file heten: dat is de enige veldnaam die multer accepteert. Al het andere zijn gewone formuliervelden in hetzelfde verzoek: api_key, een optioneel path (de map waar het in komt, standaard /), een optionele boolean make_public en een optionele waarde tags (een door komma's gescheiden string of een 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'])

Het antwoord

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 antwoordt met code: 760, niet de gebruikelijke 1: vertak op code > 0, niet op een specifieke waarde. Een naamconflict op hetzelfde pad is ook geen fout: het bestand wordt opgeslagen onder een aangepaste server_file_name en rename komt terug als true, zodat je weet dat de originele naam niet is gebruikt. filename geeft altijd de oorspronkelijke uploadnaam terug.

Fouten

Omdat deze methode geen gedeclareerde velden heeft, komt geen van deze terug als het gebruikelijke bericht 'x' is a mandatory field. Het is de eigen tekst van de handler in data, allemaal met code: -400:

Een ontbrekende of niet toegestane api_key faalt nog steeds op de gewone manier, met -401, voordat de handler wordt bereikt. Zie Errors.

Volgende stap