דילוג לתוכן
אומת

העלאת קובץ ל-Drive

הקריאה היחידה בפרק הזה שאינה גוף JSON, העלאה מסוג multipart ל-Drive של החשבון עצמו.

כל קריאה אחרת בפרק הזה שולחת את api_key ואת השדות שלה כגוף JSON אחד. upload_drive_file_user היא היוצאת מן הכלל: הקובץ עצמו צריך לנסוע כחלק multipart, ולכן api_key ושאר השדות נוסעים לצדו כשדות טופס ולא כ-JSON. נקודת הקצה עדיין /cpi/upload_drive_file_user, כמו כל שיטה אחרת, multer מותקן לפני הנתב בכל מסלול ופועל רק כשהבקשה היא באמת multipart.

שיטה

POST/cpi/upload_drive_file_user
user

Upload Drive File User

Uploads drive file to user drive.

לשיטה הזו אין רשימת שדות מוצהרת

upload_drive_file_user היא אחת מהשיטות המעטות עם מערך fields ריק ברישום (היא מקבלת קובץ, לא פרמטרים מוקלדים), ולכן ההפניה האינטראקטיבית לא יכולה להראות לכם את הקלטים שלה. ה-handler קורא אותם ישירות מהבקשה, והם משוחזרים מהקוד המקורי להלן.

הדרכה צעד אחר צעד

שולחים את הקובץ כ-multipart, לא כ-JSON

חלק הקובץ חייב להיקרא file, זה שם השדה היחיד ש-multer מוגדר לקבל. כל השאר הם שדות טופס רגילים באותה בקשה: api_key, path אופציונלי (התיקייה שבה ימוקם, ברירת המחדל /), ערך בוליאני אופציונלי make_public, וערך tags אופציונלי (מחרוזת מופרדת בפסיקים או מערך 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'])

התשובה

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
}

הצלחה עונה code: 760, לא 1 הרגיל, מסתעפים לפי code > 0 ולא לפי ערך מסוים. התנגשות שם באותו נתיב אינה שגיאה גם היא: הקובץ נשמר תחת server_file_name שהופרד מהאחרים ו-rename חוזר true כדי שתדעו שהשם המקורי לא היה זה שנעשה בו שימוש בפועל. filename תמיד משקף את שם ההעלאה המקורי בכל מקרה.

שגיאות

מכיוון שלשיטה הזו אין שדות מוצהרים, אף אחת מהן לא חוזרת בהודעה הרגילה 'x' is a mandatory field, אלה הטקסט של ה-handler עצמו ב-data, כולן ב-code: -400:

api_key חסר או לא מורשה עדיין נכשל באופן הרגיל, ב--401, עוד לפני שמגיעים אל ה-handler. ראו שגיאות.

הבא