camera.uploadFile

O app emite esse comando para a câmera a fim de iniciar o upload de uma imagem ou vídeo diretamente da câmera para um servidor. A câmera precisa usar os parâmetros incluídos para formar uma solicitação POST de HTTP. O arquivo a ser enviado é especificado por fileUrl e precisa ser enviado para uploadUrl com a autorização correta especificada por accessToken. Este comando foi adicionado no nível 2.1 da API e é relevante para o upload direto

É possível fazer isso em uma linha de comando no computador da seguinte forma:

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

Parâmetros

  • fileUrl: é o URL do arquivo a ser enviado para o servidor.
  • uploadUrl: Uma string que representa o local do upload do arquivo.
  • accessToken:: um token que inclui as informações de autenticação do upload. Ele é recebido pelo app e enviado à câmera.

Resultados

  • Este comando não retorna nenhum resultado.

Erros

  • missingParameter: Alguns parâmetros estão ausentes, por exemplo, fileUrl.
  • invalidParameterName: Um ou mais nomes de parâmetros de entrada não foram reconhecidos.
  • Os nomes dos parâmetros de entrada invalidParameterValue: são reconhecidos, mas um ou mais valores transmitidos são inválidos. Por exemplo, o arquivo especificado pelo fileUrl não existe.
  • Falha no upload da câmera: uploadError:.
E/S de comando
Entrada de comando
{
"parameters": {
"fileUrl": "URL of the file.",
"uploadUrl": "A string representing where to upload the file.",
"accessToken": "A token containing the authentication information."
}
}
Resposta ao comando
none
Resposta ao comando (erro)
{
"error": {
"code": "uploadError",
"message": "Camera failed to upload the file."
}
}