camera.uploadFile

Ứng dụng đưa ra lệnh này cho máy ảnh để bắt đầu tải hình ảnh hoặc video lên ngay từ máy ảnh đến máy chủ. Máy ảnh phải sử dụng các thông số đi kèm để tạo yêu cầu HTTP POST. Tệp được tải lên do fileUrl chỉ định và phải được tải lên uploadUrl bằng lệnh uỷ quyền chính xác do accessToken chỉ định. Lệnh này được thêm vào từ API cấp 2.1 và phù hợp với tính năng Tải lên trực tiếp

Bạn có thể thực hiện việc này từ dòng lệnh trên máy tính như sau:

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

Các tham số

  • fileUrl: URL của tệp sẽ được tải lên máy chủ.
  • uploadUrl: Một chuỗi đại diện cho vị trí tải tệp lên.
  • accessToken: Mã thông báo bao gồm thông tin xác thực để tải lên. Thông tin này được ứng dụng thu thập và gửi đến máy ảnh.

Kết quả

  • Lệnh này không trả về kết quả nào.

Lỗi

  • missingParameter: Một số thông số, ví dụ: fileUrl bị thiếu.
  • invalidParameterName: Một hoặc nhiều tên tham số đầu vào không nhận dạng được.
  • invalidParameterValue: Tên tham số đầu vào được nhận dạng nhưng một hoặc nhiều giá trị đã truyền không hợp lệ. Ví dụ: tệp do fileUrl chỉ định không tồn tại.
  • Không tải được uploadError: camera lên.
Lệnh I/O
Nhập dữ liệu lệnh 
{
    "parameters": {
        "fileUrl": "URL of the file.",
        "uploadUrl": "A string representing where to upload the file.",
        "accessToken": "A token containing the authentication information."
    }
}
Kết quả lệnh 
none
Kết quả đầu ra của lệnh (Lỗi) 
{
    "error": {
        "code": "uploadError",
        "message": "Camera failed to upload the file."
    }
}