Preskočiť na obsah
Overené

Nahrať súbor na Drive

Jediné volanie v tejto sekcii, ktoré nie je telo JSON, nahrávanie multipart na vlastný Drive účtu.

Každé iné volanie v tejto sekcii posiela api_key a svoje polia ako jedno telo JSON. upload_drive_file_user je výnimka: samotný súbor musí putovať ako časť multipart, takže api_key a ostatné polia idú vedľa neho ako polia formulára namiesto JSON. Koncový bod je stále /cpi/upload_drive_file_user, rovnako ako pri každej inej metóde, multer je pripojený pred smerovač pri každej ceste a koná, len keď je požiadavka skutočne multipart.

Method

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Táto metóda nemá deklarovaný zoznam polí

upload_drive_file_user je jedna z mála metód s prázdnym poľom fields v registri (berie súbor, nie typované parametre), takže interaktívna referencia vám nemôže ukázať jej vstupy. Obsluha ich číta priamo z požiadavky a nižšie sú uvedené podľa zdroja.

Walkthrough

Send the file as multipart, not JSON

Časť so súborom sa musí volať file, to je jediný názov poľa, ktorý multer akceptuje. Všetko ostatné je bežné pole formulára v tej istej požiadavke: api_key, voliteľné path (priečinok, do ktorého sa súbor umiestni, predvolene /), voliteľný boolean make_public a voliteľná hodnota tags (reťazec oddelený čiarkami alebo pole 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'])

The response

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
}

Úspech odpovie code: 760, nie obvyklé 1, vetvte podľa code > 0, nie podľa konkrétnej hodnoty. Ani kolízia názvu na tej istej ceste nie je chyba: súbor sa uloží pod rozlíšeným server_file_name a rename sa vráti ako true, aby ste vedeli, že sa nepoužil pôvodný názov. filename vždy opakuje pôvodný názov nahratia bez ohľadu na to.

Errors

Pretože táto metóda nemá deklarované polia, žiadna z nich sa nevracia ako obvyklá správa 'x' is a mandatory field, sú to vlastné texty obsluhy v data, všetky pri code: -400:

Chýbajúci alebo neoprávnený api_key stále zlyhá obvyklým spôsobom, pri -401, ešte predtým, než sa k obsluhe vôbec dostane. Pozrite si Errors.

Next