Intégration
API de l'Orchestrator
Publier des processus, lancer des jobs et gérer les déclencheurs par HTTP.
L'Orchestrator expose une API HTTP JSON (par défaut http://localhost:17880).
Authentification
Ajoutez à chaque requête un jeton personnel, créé dans ZOKAS Agent, dans l'un de ces en-têtes :
X-ZOKAS-Key: zk_…
Authorization: Bearer zk_…Sans jeton valide : 401 Authentification requise.
Processus
| Méthode | Chemin | Description |
|---|---|---|
POST | /processes?project_id= | Publie ou met à jour un package. 422 si le format n'est pas zokas.package/1. |
GET | /processes | Liste des processus publiés. |
GET | /processes/{id ou nom} | Processus et son package complet. |
POST | /processes/{id}/delete | Supprime un processus. |
Jobs
| Méthode | Chemin | Description |
|---|---|---|
POST | /jobs | Lance un job. |
GET | /jobs · /jobs/{id} | Liste, détail et journal. |
POST | /jobs/{id}/stop | Arrête un job. |
POST | /jobs/{id}/resume | Reprend un job échoué à l'étape en erreur. |
Corps de POST /jobs :
| Champ | Type | Description |
|---|---|---|
process | chaîne | Nom ou identifiant du processus (job déterministe). |
goal | chaîne | Objectif en langage naturel (mission). Exclusif avec process. |
variables | objet | Variables de lancement ; priment sur celles du package. |
robot | chaîne | Robot imposé (ex. robot-vm-01). |
origin | chaîne | Origine affichée dans le journal. Défaut : API. |
screenshots | énumération | default, robot, nav, all, off. |
Codes d'erreur : 402 licence absente, 404 processus ou robot inconnu, 422 corps invalide ou IA non configurée.
Déclencheurs
| Méthode | Chemin | Description |
|---|---|---|
GET | /triggers?process= | Liste. |
POST | /triggers | Crée : name, process_id, kind, spec, variables, robot, enabled. |
POST | /triggers/{id} | Modifie. |
POST | /triggers/{id}/run | Exécute maintenant. |
POST | /hooks/{id} | Point d'entrée des webhooks (voir Automatiser les lancements). |
Serveur MCP
Le service orchestrator-mcp (port 17881) expose les mêmes opérations sous forme d'outils MCP, pour Claude Desktop, Claude Code ou tout client MCP.
Source : orchestrator/zokas_orch/api.py, orchestrator/zokas_orch/routes.py, orchestrator/zokas_orch/mcp_server.py.
Mis à jour le 28 octobre 2026