Kamera-Uploaddatei

Die App gibt diesen Befehl an die Kamera aus, um ein Bild oder Video direkt von der Kamera auf einen Server hochzuladen. Die Kamera sollte die enthaltenen Parameter verwenden, um eine HTTP-POST-Anfrage zu erstellen. Die hochzuladende Datei ist in fileUrl angegeben und sollte mit der korrekten accessToken-Berechtigung in uploadUrl hochgeladen werden. Dieser Befehl wurde auf API-Ebene 2.1 hinzugefügt und ist für den direkten Upload relevant.

In der Befehlszeile würde dies folgendermaßen aussehen:

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

Parameter

  • fileUrl: Die URL der Datei, die auf den Server hochgeladen werden soll.
  • uploadUrl: Ein String, der angibt, wo die Datei hochgeladen werden soll.
  • accessToken: Ein Token, das die Authentifizierungsinformationen für den Upload enthält. Sie wird von der App abgerufen und an die Kamera gesendet.

Ergebnisse

  • Dieser Befehl gibt kein Ergebnis zurück.

Fehler

  • missingParameter: Ein Parameter fehlt, z. B. fileUrl.
  • invalidParameterName: Mindestens ein Eingabeparametername ist unbekannt.
  • invalidParameterValue: Namen von Eingabeparametern wurden erkannt, aber ein oder mehrere übergebene Werte sind ungültig. Die von fileUrl angegebene Datei ist beispielsweise nicht vorhanden.
  • uploadError: Kamera konnte nicht hochgeladen werden.
Befehls-E/A
Befehlseingabe 
{
    "parameters": {
        "fileUrl": "URL of the file.",
        "uploadUrl": "A string representing where to upload the file.",
        "accessToken": "A token containing the authentication information."
    }
}
Befehlsausgabe 
none
Befehlsausgabe (Fehler) 
{
    "error": {
        "code": "uploadError",
        "message": "Camera failed to upload the file."
    }
}