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: อัปโหลดกล้องไม่สําเร็จ
คําสั่ง 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."
    }
}