Przejdź do treści
Zweryfikowano

Prześlij plik na Dysk

Jedyne wywołanie w tej sekcji, które nie jest treścią JSON, przesyłanie multipart na własny Dysk konta.

Każde inne wywołanie w tej sekcji wysyła api_key i swoje pola jako jedną treść JSON. upload_drive_file_user jest wyjątkiem: sam plik musi podróżować jako część multipart, więc api_key i pozostałe pola jadą obok niego jako pola formularza, a nie JSON. Punkt końcowy to nadal /cpi/upload_drive_file_user, jak każda inna metoda, multer jest zamontowany przed routerem dla każdej trasy i działa tylko wtedy, gdy żądanie jest faktycznie multipart.

Metoda

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Ta metoda nie ma zadeklarowanej listy pól

upload_drive_file_user to jedna z garstki metod z pustą tablicą fields w rejestrze (przyjmuje plik, a nie typowane parametry), więc interaktywna referencja nie pokaże jej danych wejściowych. Procedura obsługi czyta je wprost z żądania, a poniżej są odtworzone ze źródła.

Krok po kroku

Wyślij plik jako multipart, a nie JSON

Część z plikiem musi nazywać się file, to jedyna nazwa pola, którą multer jest skonfigurowany przyjmować. Wszystko inne to zwykłe pola formularza w tym samym żądaniu: api_key, opcjonalne path (folder, w którym go umieścić, domyślnie /), opcjonalna wartość logiczna make_public i opcjonalna wartość tags (ciąg rozdzielony przecinkami albo tablica 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'])

Odpowiedź

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
}

Sukces odpowiada code: 760, a nie zwykłym 1, rozgałęziaj się po code > 0, a nie po konkretnej wartości. Kolizja nazwy w tej samej ścieżce też nie jest błędem: plik zostaje zapisany pod rozróżnioną nazwą server_file_name, a rename wraca jako true, żebyś wiedział, że faktycznie użyto innej nazwy niż oryginalna. filename zawsze zwraca oryginalną nazwę przesłania.

Błędy

Ponieważ ta metoda nie ma zadeklarowanych pól, żaden z nich nie wraca jako zwykły komunikat 'x' is a mandatory field, to własny tekst procedury obsługi w data, wszystkie przy code: -400:

Brakujący lub nieautoryzowany api_key nadal zawodzi normalnie, przy -401, zanim procedura obsługi w ogóle zostanie osiągnięta. Zobacz Błędy.

Dalej