מצלמה.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: נכשלה.
Command 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."
    }
}