Statut

L'API /osc/commands/status renvoie le statut des commandes inProgress précédentes. L'API status est utile pour analyser la progression d'une commande précédemment exécutée ; par exemple, pour déterminer si la commande camera.takePicture a bien été exécutée.

Entrée

Nom Type Description
id Chaîne Identifiant de commande renvoyé par un appel précédent à /osc/commands/execute.

Sortie

Le résultat est également un objet de commande (voir Sortie de /osc/commands/execute)

Erreur

Code d'erreur Description
missingParameter La valeur id n'est pas spécifiée. Ce paramètre requiert un identifiant de commande renvoyé par un appel précédent à /osc/commands/execute.
invalidParameterName Le paramètre d'entrée est inconnu.
invalidParameterValue Le paramètre d'entrée est reconnu, mais sa valeur n'est pas valide ; par exemple, la valeur id n'existe pas ou son type est incorrect.

Exemple

Requête
POST /osc/commands/status HTTP/1.1
Host: [camera ip address]:[httpPort]
Content-Type: application/json;charset=utf-8
Accept: application/json
Content-Length: {CONTENT_LENGTH}
X-XSRF-Protected: 1

{
    "id": "90ABCD"
}
Réponse
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "name": "camera.takePicture",
    "state": "done",
    "results": {
        "fileUri": "ABC.JPG"
    }
}