camera.uploadFile

L'app invia questo comando alla fotocamera per avviare il caricamento di un'immagine o di un video direttamente dalla fotocamera su un server. La videocamera deve utilizzare i parametri inclusi per formare una richiesta POST HTTP. Il file da caricare è specificato da fileUrl e deve essere caricato su uploadUrl con l'autorizzazione corretta specificata da accessToken. Questo comando è stato aggiunto al livello API 2.1 ed è pertinente al caricamento diretto

Per farlo, puoi utilizzare una riga di comando del computer nel seguente modo:

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

Parametri

  • fileUrl: L'URL del file da caricare sul server.
  • uploadUrl: Una stringa che rappresenta dove caricare il file.
  • accessToken: Un token che include le informazioni di autenticazione per il caricamento. Viene ottenuto dall'app e inviato alla fotocamera.

Risultati

  • Questo comando non restituisce alcun risultato.

Errori

  • missingParameter: Mancano alcuni parametri, ad esempio fileUrl.
  • invalidParameterName: Uno o più nomi di parametri di input non sono riconosciuti.
  • invalidParameterValue: I nomi dei parametri di input vengono riconosciuti, ma uno o più valori trasmessi non sono validi. Ad esempio, il file specificato da fileUrl non esiste.
  • uploadError: Caricamento della fotocamera non riuscito.
I/O di comando
Input di comando
{
"parameters": {
"fileUrl": "URL of the file.",
"uploadUrl": "A string representing where to upload the file.",
"accessToken": "A token containing the authentication information."
}
}
Output comando
none
Output comando (errore)
{
"error": {
"code": "uploadError",
"message": "Camera failed to upload the file."
}
}