Sari la conținut
Verificat

Încarcă un fișier în Drive

Singurul apel din această secțiune care nu este un corp JSON, o încărcare multipart în Drive-ul propriu al contului.

Fiecare alt apel din această secțiune trimite api_key și câmpurile lui ca un singur corp JSON. upload_drive_file_user este excepția: fișierul însuși trebuie să călătorească ca parte multipart, așa că api_key și restul câmpurilor îl însoțesc ca câmpuri de formular, nu ca JSON. Endpointul rămâne /cpi/upload_drive_file_user, ca la orice altă metodă, multer este montat înaintea routerului pentru fiecare rută și acționează doar când cererea este într-adevăr multipart.

Metodă

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Această metodă nu are o listă declarată de câmpuri

upload_drive_file_user este una dintre puținele metode cu un șir fields gol în registru (primește un fișier, nu parametri tastați), așa că referința interactivă nu îți poate arăta intrările. Ele sunt citite direct din cerere de către handler și sunt reproduse mai jos din sursă.

Parcurgere

Trimite fișierul ca multipart, nu ca JSON

Partea de fișier trebuie să se numească file, singurul nume de câmp pe care multer este configurat să îl accepte. Orice altceva este un câmp de formular obișnuit în aceeași cerere: api_key, un path opțional (folderul în care îl pui, implicit /), un boolean opțional make_public și o valoare opțională tags (un șir separat prin virgule sau un șir 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'])

Răspunsul

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
}

Succesul răspunde cu code: 760, nu obișnuitul 1, ramifică după code > 0, nu după o valoare anume. O coliziune de nume la aceeași cale nu este nici ea o eroare: fișierul este stocat sub un server_file_name diferențiat, iar rename revine true, ca să știi că numele original nu este cel folosit de fapt. filename returnează mereu numele original al încărcării.

Erori

Deoarece această metodă nu are câmpuri declarate, niciuna dintre acestea nu revine ca obișnuitul mesaj 'x' is a mandatory field, sunt textele proprii ale handlerului în data, toate cu code: -400:

Un api_key lipsă sau neautorizat eșuează în continuare normal, la -401, înainte să se ajungă vreodată la handler. Vezi Erori.

Urmează