Consulter l'état d'une exécution

Consultez l'état courant d'une exécution que vous avez lancée, à l'aide du jobExecutionId renvoyé par Lancer un job.

---

Endpoint

GET /job/api/jobs/executions/{jobExecutionId}

Exigence	Valeur
En‑tête	X-API-Key: <votre clé>
Scope	READ
Paramètre de chemin	jobExecutionId — l'ID renvoyé au lancement du job

---

Exemple

curl https://<votre-backend-job>/job/api/jobs/executions/1287 \
  -H "X-API-Key: amk_live_3f2a8b1c9d2e4f5a6b7c8d9e"

---

Réponse — 200 OK

{
  "jobExecutionId": 1287,
  "jobName": "qos-sms-test",
  "deviceId": "device-42",
  "deviceName": "Samsung A12",
  "execState": "EXECUTING",
  "launchedAt": "2026-06-27T14:32:10"
}

Champ	Type	Description
jobExecutionId	Long	ID de l'exécution
jobName	String	Le job lancé
deviceId	String	ID du device cible
deviceName	String	Nom du device cible
execState	String	État courant (voir ci‑dessous)
launchedAt	DateTime	Date de création de l'exécution

---

États d'exécution

État	Signification
PENDING	Créée, pas encore prise en charge par le device
EXECUTING	En cours d'exécution sur le device
SUCCESS	Terminée avec succès
FAILURE	Terminée en erreur

Interrogez cet endpoint jusqu'à ce que execState passe à SUCCESS ou FAILURE (états finaux).

---

Erreurs

Statut	code	message	Cause
403	J-802	Invalid API key	Clé absente / inconnue / révoquée
403	J-803	API key is expired	La date d'expiration de la clé est passée
403	J-804	API key does not have the required permission	La clé n'a pas le scope READ
404	J-501	Job execution not found	Le jobExecutionId ne vous appartient pas ou n'existe pas

Exemple de corps d'erreur :

{
  "code": "J-804",
  "message": "API key does not have the required permission: READ",
  "status": 403
}