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"
}
} |