Aller au contenu
Brouillon

Envoyer un fichier dans Drive

[object Object]

Tous les autres appels de cette section envoient api_key et leurs champs dans un seul corps JSON. upload_drive_file_user fait exception : le fichier lui-même doit voyager comme une partie multipart, donc api_key et les autres champs l'accompagnent sous forme de champs de formulaire au lieu du JSON. Le point d'accès reste /cpi/upload_drive_file_user, comme n'importe quelle autre méthode ; multer est monté devant le routeur pour toutes les routes et n'agit que lorsque la requête est réellement multipart.

Méthode

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

Cette méthode n'a pas de liste de champs déclarés

upload_drive_file_user fait partie des rares méthodes dont le tableau fields est vide dans le registre (elle prend un fichier, pas des paramètres typés) : la référence interactive ne peut donc pas vous montrer ses entrées. Le gestionnaire les lit directement dans la requête, et elles sont reproduites ci-dessous à partir de la source.

Pas à pas

Envoyez le fichier en multipart, pas en JSON

La partie fichier doit s'appeler file : c'est le seul nom de champ que multer est configuré pour accepter. Tout le reste est un champ de formulaire ordinaire sur la même requête : api_key, un path facultatif (le dossier où le placer, / par défaut), un booléen make_public facultatif, et une valeur tags facultative (une chaîne séparée par des virgules ou un tableau 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'])

La réponse

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
}

Le succès répond code: 760, pas le 1 habituel : testez code > 0, pas une valeur précise. Une collision de nom au même chemin n'est pas non plus une erreur : le fichier est enregistré sous un server_file_name rendu unique et rename revient à true, pour que vous sachiez que le nom d'origine n'est pas celui qui a été utilisé. filename reprend toujours le nom d'envoi d'origine.

Erreurs

Comme cette méthode n'a pas de champs déclarés, aucune de ces erreurs ne revient sous la forme habituelle du message 'x' is a mandatory field : c'est le texte propre au gestionnaire dans data, toujours à code: -400 :

Une api_key manquante ou non autorisée échoue toujours de la façon normale, à -401, avant même d'atteindre le gestionnaire. Consultez Erreurs.

Suite