Přeskočit na obsah
Ověřeno

Nahrát soubor na Disk

Jediné volání v této sekci, které není tělo JSON: nahrání typu multipart na vlastní Disk účtu.

Každé jiné volání v této sekci posílá api_key a svá pole jako jedno tělo JSON. upload_drive_file_user je výjimka: samotný soubor musí putovat jako část multipart, takže api_key a ostatní pole jedou vedle něj jako pole formuláře, ne jako JSON. Koncový bod je stále /cpi/upload_drive_file_user, stejně jako u každé jiné metody, multer je připojen před routerem pro každou trasu a zasáhne jen tehdy, když je požadavek skutečně multipart.

Metoda

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Tato metoda nemá deklarovaný seznam polí

upload_drive_file_user je jednou z několika metod s prázdným polem fields v registru (bere soubor, ne typované parametry), takže interaktivní reference vám neukáže její vstupy. Obslužná rutina je čte přímo z požadavku a níže jsou uvedeny ze zdrojového kódu.

Postup

Poslat soubor jako multipart, ne JSON

Část se souborem se musí jmenovat file, to je jediný název pole, který multer přijímá. Všechno ostatní jsou běžná pole formuláře na tomtéž požadavku: api_key, volitelná path (složka, do které se soubor umístí, výchozí /), volitelný boolean make_public a volitelná hodnota tags (řetězec oddělený čárkami nebo 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'])

Odpověď

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
}

Úspěch odpovídá code: 760, ne obvyklým 1, větvete podle code > 0, ne podle konkrétní hodnoty. Kolize názvu na téže cestě také není chyba: soubor se uloží pod rozlišeným server_file_name a rename se vrátí jako true, abyste věděli, že se ve skutečnosti nepoužil původní název. filename vždy vrací původní název nahrávaného souboru.

Chyby

Protože tato metoda nemá deklarovaná pole, žádná z těchto chyb se nevrací jako obvyklá zpráva 'x' is a mandatory field, jde o vlastní text obslužné rutiny v data, vše s code: -400:

Chybějící nebo neoprávněný api_key stále selže normálně, s -401, ještě než se k obslužné rutině vůbec dojde. Viz Chyby.

Dále