archivo.uploadFile

La app emite este comando a la cámara para iniciar la carga de una imagen o un video directamente desde la cámara a un servidor. La cámara debe usar los parámetros incluidos para formar una solicitud HTTP POST. fileUrl especifica el archivo que se subirá y debe subirse a uploadUrl con la autorización correcta que especifica accessToken. Este comando se agregó en el nivel de API 2.1 y es relevante para la carga directa

Se podría hacer esto desde una línea de comandos de la computadora de la siguiente manera:

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

Parámetros

  • fileUrl: Es la URL del archivo que se subirá al servidor.
  • uploadUrl: Es una string que representa dónde subir el archivo.
  • accessToken: Un token que incluye la información de autenticación para la carga. La app la obtiene y la envía a la cámara.

Resultados

  • Este comando no muestra ningún resultado.

Errores

  • missingParameter: Falta algún parámetro, por ejemplo, fileUrl.
  • invalidParameterName: No se reconocen uno o más nombres de parámetros de entrada.
  • Se reconocen los nombres de los parámetros de entrada invalidParameterValue:, pero uno o más valores pasados no son válidos. Por ejemplo, el archivo especificado por fileUrl no existe.
  • uploadError: No se pudo subir la cámara.
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."
}
}
Resultado del comando
none
Resultado del comando (error)
{
"error": {
"code": "uploadError",
"message": "Camera failed to upload the file."
}
}