Zum Inhalt springen
Geprüft

Eine Datei zu Drive hochladen

Der einzige Aufruf in diesem Abschnitt ohne JSON-Body: ein Multipart-Upload in das eigene Drive des Kontos.

Jeder andere Aufruf in diesem Abschnitt sendet api_key und seine Felder als einen JSON-Body. upload_drive_file_user ist die Ausnahme: Die Datei selbst muss als Multipart-Teil übertragen werden, daher reisen api_key und die übrigen Felder als Formularfelder daneben statt als JSON. Der Endpunkt ist weiterhin /cpi/upload_drive_file_user, wie bei jeder anderen Methode. multer ist bei jeder Route vor dem Router eingehängt und greift nur, wenn die Anfrage tatsächlich Multipart ist.

Methode

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Diese Methode hat keine deklarierte Feldliste

upload_drive_file_user ist eine der wenigen Methoden mit einem leeren fields-Array in der Registry (sie nimmt eine Datei, keine typisierten Parameter), daher kann die interaktive Referenz ihre Eingaben nicht anzeigen. Der Handler liest sie direkt aus der Anfrage, unten sind sie aus dem Quellcode wiedergegeben.

Schritt für Schritt

Sende die Datei als Multipart, nicht als JSON

Der Dateiteil muss file heißen, das ist der einzige Feldname, den multer annimmt. Alles andere sind gewöhnliche Formularfelder derselben Anfrage: api_key, ein optionaler path (der Ordner, in den die Datei kommt, Standard ist /), ein optionaler Boolean make_public und ein optionaler tags-Wert (ein durch Kommas getrennter String oder ein 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'])

Die Antwort

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
}

Erfolg antwortet mit code: 760, nicht dem üblichen 1. Verzweige nach code > 0, nicht nach einem bestimmten Wert. Eine Namenskollision am selben Pfad ist ebenfalls kein Fehler: Die Datei wird unter einem eindeutig gemachten server_file_name gespeichert, und rename kommt als true zurück, damit du weißt, dass der ursprüngliche Name nicht der war, der tatsächlich verwendet wurde. filename gibt immer den ursprünglichen Upload-Namen wieder.

Fehler

Da diese Methode keine deklarierten Felder hat, kommt keine davon als die übliche Meldung 'x' is a mandatory field zurück. Es ist der eigene Text des Handlers in data, jeweils mit code: -400:

Ein fehlender oder nicht berechtigter api_key scheitert weiterhin auf dem normalen Weg bei -401, bevor der Handler überhaupt erreicht wird. Siehe Fehler.

Weiter