aparat.przesyłaniepliku

Aplikacja wysyła to polecenie do aparatu, aby rozpocząć przesyłanie obrazu lub filmu bezpośrednio z aparatu na serwer. Kamera powinna użyć podanych parametrów, by utworzyć żądanie HTTP POST. Przesyłany plik określa fileUrl. Należy go przesłać do domeny uploadUrl z prawidłową autoryzacją określoną przez accessToken. To polecenie zostało dodane na poziomie API 2.1 i dotyczy przesyłania bezpośredniego

Aby to zrobić, użyj wiersza poleceń komputera:

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

Parametry

  • fileUrl: Adres URL pliku, który ma zostać przesłany na serwer.
  • uploadUrl: Ciąg znaków wskazujący, gdzie przesłać plik.
  • accessToken: Token zawierający informacje uwierzytelniające do przesłania. Jest ona odbierana przez aplikację i wysyłana do aparatu.

Wyniki

  • To polecenie nie zwraca żadnego wyniku.

Błędy

  • missingParameter: Brak parametru, np. fileUrl.
  • invalidParameterName: Nie rozpoznano nazwy parametru wejściowego.
  • invalidParameterValue: Nazwy parametrów wejściowych są rozpoznawane, ale co najmniej 1 przekazana wartość jest nieprawidłowa. Na przykład plik określony w polu fileUrl nie istnieje.
  • Nie udało się przesłać uploadError: kamery.
Command/I/O
Dane wejściowe polecenia 
{
    "parameters": {
        "fileUrl": "URL of the file.",
        "uploadUrl": "A string representing where to upload the file.",
        "accessToken": "A token containing the authentication information."
    }
}
Dane wyjściowe polecenia 
none
Dane wyjściowe polecenia (błąd) 
{
    "error": {
        "code": "uploadError",
        "message": "Camera failed to upload the file."
    }
}