Camera.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: ชื่อพารามิเตอร์อินพุตอย่างน้อย 1 รายการ ไม่รู้จัก
  • invalidParameterValue: จดจำชื่อพารามิเตอร์อินพุตได้ แต่มีค่าที่ส่งผ่านอย่างน้อย 1 ค่าไม่ถูกต้อง ตัวอย่างเช่น ไฟล์ที่ระบุโดย ไม่มี 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."
    }
}