Webhook - Statut du Job

Notification envoyée automatiquement par le système Temporal à chaque changement de statut d’un job. Le webhook est déclenché si callback_url est présent dans le champ metadata du job.

Cycle de vie des notifications

Ordre	Statut	Description
1	IN_PROGRESS	Le job a été pris en charge par un provider
2a	COMPLETED	Le job est terminé avec succès (contient output, cost, duration)
2b	FAILED	Le job a échoué (le message contient l’erreur)
2c	CANCELLED	Le job a été annulé

Sécurité HMAC-SHA256

Si callback_secret est fourni dans metadata lors de la création du job, chaque requête webhook inclut un header X-Webhook-Signature contenant la signature HMAC-SHA256 du body. Le body est sérialisé en JSON compact trié (sort_keys=True, separators=(',', ':')).

WEBHOOK jobStatusUpdate

JSON

in_progress

{
  "status": "IN_PROGRESS",
  "message": "Job processing started",
  "metadata": {
    "callback_url": "https://your-server.com/webhook"
  }
}

Headers

X-Webhook-Signature · string

Signature HMAC-SHA256 du body (présente uniquement si callback_secret a été fourni lors de la création du job)

Example:

"a1b2c3d4e5f6..."

Body

application/json

status · enum<string> · required

Statut actuel du job

Available options: IN_PROGRESS, COMPLETED, FAILED, CANCELLED

message · string · required

Message décrivant le statut ou l'erreur

Examples:

"Job processing started"

"Job completed successfully"

"Workflow cancelled"

metadata · object · required

Métadonnées du job (sans callback_secret). Contient les données passées dans metadata lors de la création du job, ce qui permet de corréler la notification avec votre système.

Example:

{
  "callback_url": "https://your-server.com/webhook"
}

cost · number | null

Coût de la génération en USD. Présent uniquement quand status = COMPLETED.

Example:

0.0035

duration · number | null

Durée d'exécution en secondes. Présent uniquement quand status = COMPLETED.

Example:

12.4

output · object

Résultat de la génération. Présent uniquement quand status = COMPLETED.

Show child attributes

Response

200

Notification reçue avec succès. Le système considère tout code 2xx comme un succès.