kamera.uploadFile

Aplikasi memberikan perintah ini ke kamera untuk memulai upload gambar atau video langsung dari kamera ke server. Kamera harus menggunakan parameter untuk membentuk permintaan POST HTTP. File yang akan diupload ditentukan oleh fileUrl dan file harus diupload ke uploadUrl dengan otorisasi yang ditetapkan oleh accessToken. Perintah ini ditambahkan di level API 2.1 dan relevan dengan Upload Langsung

Kita dapat melakukan ini dari baris perintah komputer sebagai:

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

Parameter

  • fileUrl: URL file yang akan diupload ke server.
  • uploadUrl: String yang mewakili tempat mengupload file.
  • accessToken: Token yang mencakup informasi autentikasi untuk upload. Data ini diperoleh oleh aplikasi dan dikirim ke kamera.

Hasil

  • Perintah ini tidak menampilkan hasil.

Error

  • missingParameter: Beberapa parameter, misalnya, fileUrl tidak ada.
  • invalidParameterName: Satu atau beberapa nama parameter input tidak dikenal.
  • invalidParameterValue: Nama parameter input dikenali tetapi satu atau beberapa nilai yang diteruskan tidak valid. Misalnya, file yang ditentukan oleh fileUrl tidak ada.
  • uploadError: Kamera gagal diupload.
I/O Perintah
Input Perintah 
{
    "parameters": {
        "fileUrl": "URL of the file.",
        "uploadUrl": "A string representing where to upload the file.",
        "accessToken": "A token containing the authentication information."
    }
}
Output Perintah 
none
Output Perintah (Error) 
{
    "error": {
        "code": "uploadError",
        "message": "Camera failed to upload the file."
    }
}