camera.uploadFile

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

Dalla riga di comando di un computer, si potrebbe eseguire questa operazione:

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 per il caricamento. Viene ottenuto dall'app e inviato alla fotocamera.

Risultati

  • Questo comando non restituisce alcun risultato.

Errori

  • missingParameter: Manca alcuni parametri, ad esempio fileUrl.
  • invalidParameterName: Uno o più nomi di parametri di input sono non riconosciuto.
  • invalidParameterValue: I nomi dei parametri di input sono riconosciuti ma uno o più valori trasmessi non sono validi. Ad esempio, il file specificato fileUrl non esiste.
  • uploadError: Impossibile caricare la videocamera.
I/O comando
Input 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."
    }
}