מצלמה.uploadFile

האפליקציה שולחת את הפקודה הזו למצלמה כדי ליזום העלאה של תמונה או סרטון ישירות מהמצלמה. המצלמה צריכה להשתמש בפרמטרים הכלולים כדי ליצור בקשת HTTP POST. הקובץ שרוצים להעלות צוין על ידי fileUrl. יש להעלות אותו ל-uploadUrl עם ההרשאה הנכונה שצוינה ב-accessToken. פקודה זו נוספה ברמת API 2.1 והיא רלוונטית ל-העלאה ישירה

ניתן לעשות זאת משורת פקודה במחשב:

curl -X post -H "Authorization: Bearer accessToken" -T fileUrl uploadUrl

פרמטרים

  • fileUrl: כתובת ה-URL של הקובץ שיועלה לשרת.
  • uploadUrl: מחרוזת שמייצגת את המיקום שאליו יש להעלות את הקובץ.
  • accessToken: אסימון שכולל את פרטי האימות להעלאה. היא מתקבל על ידי האפליקציה ונשלחת למצלמה.

תוצאות

  • הפקודה הזו לא מחזירה תוצאות.

שגיאות

  • missingParameter: חסר פרמטר, לדוגמה, fileUrl.
  • invalidParameterName: שם אחד או יותר של פרמטר קלט לא מוכר.
  • invalidParameterValue: המערכת מזהה שמות של פרמטרים להזנת קלט, אבל ערך אחד או יותר שמועבר אינו חוקי. לדוגמה, הקובץ שצוין על ידי fileUrl לא קיים.
  • העלאת המצלמה של uploadError: נכשלה.
פקודה: I/O
קלט פקודה 
{
    "parameters": {
        "fileUrl": "URL of the file.",
        "uploadUrl": "A string representing where to upload the file.",
        "accessToken": "A token containing the authentication information."
    }
}
פלט פקודה 
none
פלט פקודה (שגיאה) 
{
    "error": {
        "code": "uploadError",
        "message": "Camera failed to upload the file."
    }
}