POST /api/embed
Crée un exécutable autonome à partir de deux dossiers: code/ et executable/.
Entrée
| Champ | Type | Requis | Description |
|---|
code | string | oui | Dossier à empaqueter sous code/. |
executable | string | non | Dossier empaqueté sous executable/ (défaut: dossier de l’exe courant). |
output | string | oui | Chemin de l’exécutable de sortie. |
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec. |
message | string | Détail de l’opération. |
POST /api/useConfig
Change à chaud le dossier servi (code) et le dossier des exécutables (executable).
Entrée
| Champ | Type | Requis | Description |
|---|
code | string | oui | Chemin du dossier code. |
executable | string | oui | Chemin du dossier executable. |
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec. |
message | string | Texte informatif. |
POST /api/file/<chemin-relatif>
Écrit un fichier sous la racine code/. Le chemin doit être relatif (pas de ..).
Entrées
| Élément | Valeur | Description |
|---|
| URL | /api/file/config.json | Chemin du fichier cible. |
| Header | Content-Type: application/json | Écrit du JSON (ou text/html pour HTML; application/octet-stream pour binaire). |
| Body | brut | Contenu du fichier. |
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec. |
message | string | Détail. |
path | string | Chemin relatif écrit. |
POST /api/run
Lance un exécutable depuis executable/ (CWD = code/). Les logs sont tamponnés côté serveur.
Entrée
| Champ | Type | Requis | Description |
|---|
executableName | string | oui | Nom du binaire (sans chemin). |
arguments | string | string[] | non | Arguments (ligne unique ou tableau). |
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec de lancement. |
id | number | Identifiant du processus côté serveur. |
pid | number | PID natif. |
message | string | Détail. |
POST /api/run/status
Retourne l’état du processus et les logs cumulés.
Entrée
| Champ | Type | Requis | Description |
|---|
id | number | oui | ID retourné par /api/run. |
Sortie
| Champ | Type | Description |
|---|
running | boolean | Vrai si le processus n’est pas terminé. |
status | number|null | Code de sortie s’il est terminé. |
stdout | string | Sortie standard tamponnée. |
stderr | string | Sortie d’erreur tamponnée. |
POST /api/run/stop
Demande l’arrêt d’un processus lancé par /api/run.
Entrée
| Champ | Type | Requis | Description |
|---|
id | number | oui | Identifiant du processus. |
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec. |
message | string | Détail. |
POST /api/run/stopAll
Arrête tous les processus lancés via /api/run.
Entrée
Aucun corps requis.
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec. |
message | string | Détail. |
POST /api/newServer
Démarre un serveur enfant avec son propre code/ et executable/ (port optionnel).
Entrée
| Champ | Type | Requis | Description |
|---|
code | string | oui | Dossier à servir. |
executable | string | oui | Dossier des exécutables. |
port | number | non | Port demandé (0/omis = aléatoire). |
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec. |
port | number|null | Port alloué si succès. |
message | string | Détail. |
POST /api/stop
Arrête un serveur enfant spécifique (port) ou, si appelé depuis un enfant, “ce” serveur (sans port).
Entrée
| Champ | Type | Requis | Description |
|---|
port | number | non | Port du serveur à arrêter. |
Sortie
| Champ | Type | Description |
|---|
ok | boolean | Succès / échec. |
port | number|null | Port concerné. |
message | string | Détail. |
POST /api/explorer
Explore un chemin absolu ou relatif à la racine code/. Retourne soit un fichier, soit le contenu d’un répertoire.
Entrée
| Champ | Type | Requis | Description |
|---|
path | string | non | Chemin à explorer (vide = racine code/). |
Sorties possibles
| Forme | Description |
|---|
{ type:"file", path:string, name:string, parent:string|null } | La cible est un fichier. |
{ type:"directory", path:string, parent:string|null, content: {name:string, path:string}[] } | La cible est un répertoire. |