camera.uploadFile

برنامه این دستور را به دوربین می دهد تا بارگذاری تصویر یا ویدیو را مستقیماً از دوربین به سرور آغاز کند. دوربین باید از پارامترهای موجود برای تشکیل یک درخواست HTTP POST استفاده کند. فایلی که باید آپلود شود توسط fileUrl مشخص شده است و باید با مجوز صحیح مشخص شده توسط accessToken در uploadUrl آپلود شود. این دستور در سطح API 2.1 اضافه شده است و مربوط به آپلود مستقیم است

می توان این کار را از طریق خط فرمان کامپیوتر به صورت زیر انجام داد: 

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

پارامترها

  • fileUrl: آدرس فایلی که قرار است در سرور آپلود شود.
  • uploadUrl: رشته ای که نشان دهنده محل آپلود فایل است.
  • accessToken: یک نشانه شامل اطلاعات احراز هویت برای آپلود. توسط برنامه دریافت می شود و به دوربین ارسال می شود.

نتایج

  • این دستور هیچ نتیجه ای را بر نمی گرداند.

خطاها

  • missingParameter: برخی از پارامترها، به عنوان مثال، fileUrl گم شده است.
  • invalidParameterName: نام یک یا چند پارامتر ورودی شناسایی نشده است.
  • invalidParameterValue: نام پارامترهای ورودی شناسایی می شود اما یک یا چند مقدار ارسال شده نامعتبر است. به عنوان مثال، فایل مشخص شده توسط 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."
    }
}