Service KitTerminal
Un shell Linux persistant exposé comme endpoint HTTPS. Lancez des commandes via API, connectez-vous depuis n'importe quel navigateur, streamez en WebSocket, ou SSH directement. Les sessions survivent aux reconnexions.
# Récupère votre token
$ curl -X POST \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/execute \
-H "Authorization: Bearer $TOKEN" \
-d '{"command":"echo Hello from Hoody!"}'
> { "command_id": "42", "status": "running" }
# Lance votre première commande
$ curl \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/result/42 \
-H "Authorization: Bearer $TOKEN"
> { "status": "completed", "output": "Hello from Hoody!", "exit_code": 0 }
# Partage l'URL — n'importe qui peut se connecter
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com
L'URL est l'interface
Chaque terminal a une adresse unique et prévisible. Lisez-la de gauche à droite et vous savez exactement à quel service, quelle instance et quel conteneur vous vous adressez.
https://abc123-def456-terminal-1.node-us-1.containers.hoody.comabc123Projet
L'ID de votre projet.
def456Conteneur
L'ID du conteneur.
terminalService
Quel service Kit — terminal, files, display…
1Instance
Lancez-en plusieurs : terminal-1, terminal-2, terminal-3.
node-us-1Serveur
Le nœud sur lequel votre conteneur s'exécute.
L'URL est l'interface. Pas de ports, pas de config, pas de configuration réseau.
Chaque commande est un appel API
L'exécution est asynchrone. Lancez une commande, récupérez un ID, puis lisez le résultat — ou diffusez-le en direct via WebSocket.
Envoyez une commande en POST. Vous obtenez un command_id et le statut : running immédiatement.
Interrogez l'endpoint de résultat pour récupérer la sortie combinée et le code de sortie.
Ouvrez un WebSocket pour recevoir les frames du terminal en temps réel.
Tout est intégré
Chaque fonctionnalité est dispo dès le départ, sans configuration. Terminal est prêt à l'emploi dès que votre conteneur démarre.
Un terminal complet dans le navigateur
Ouvrez l'URL sur n'importe quel appareil — téléphone, tablette, ordinateur portable. Configurez l'interface web entièrement via les paramètres de requête : shell, taille de police, mode lecture seule, titre et panneaux latéraux.
?shell=zsh?fontSize=16?readonly=true?title=Prod?panel=/docsChoix du shell
bash, zsh, fish, tmux, sh — bascule entre shells via paramètre URL. Préinstallés et prêts à l'emploi.
API d'automatisation
Envoyez des frappes de touches, collez du texte et attendez que l'écran se stabilise — pilotez des programmes interactifs via HTTP.
Captures de Terminal
Capture l'état du terminal en PNG, JPEG ou GIF via API. Couleurs et taille de police configurables pour la documentation.
État de session actif
Le répertoire de travail, le shell et l'historique sont conservés tant que la session est active et survivent aux reconnexions.
SSH vers n'importe quel serveur
Ouvrez une session sous forme de connexion SSH distante — hôte, utilisateur et clé en paramètres.
19 endpoints, contrôle total
Quatre domaines : exécution de commandes, gestion de sessions, streaming live via WebSocket et monitoring système. Chaque endpoint retourne du JSON structuré avec auth bearer token.
Exécution de commandes
5 endpointscurl -X POST .../terminal/execute -d '{"command":"npm test"}'
Gestion de sessions
6 endpointscurl .../terminal/sessions → [{ "terminal_id": "1", "shell": "bash" }]
Streaming live
4 endpointsWS .../terminal/ws — real-time terminal frames
Système & Méta
7 endpointscurl .../system/resources → { "cpu": 45.2, "memory": { ... } }
Conçu pour les vrais workflows
Terminal couvre toute la palette des scénarios devs et automatisation. Chaque cas d'usage correspond à des endpoints API et paramètres URL spécifiques.
- 01
Développement distant
GET /terminal/wsSSH dans votre conteneur depuis n'importe quel appareil avec un navigateur. Accès shell complet avec sessions persistantes — reprenez là où vous vous étiez arrêté depuis votre téléphone, votre tablette, ou une autre machine.
- 02
Orchestration d'agents IA
POST /terminal/executeLes agents exécutent des commandes shell via l'API HTTP. Build, test, déploiement — l'API Terminal donne aux agents IA un accès structuré à tout votre environnement de développement.
- 03
Debug en équipe
GET /terminal/sessionsPartagez une URL de terminal avec votre équipe pour du debug multijoueur. Tout le monde voit la même sortie, tape des commandes et reçoit des couleurs de curseur uniques en temps réel.
- 04
Applications GUI
?display=NLancez n'importe quelle application graphique depuis le terminal. Firefox, VS Code, GIMP — terminal-N se mappe automatiquement sur display-N sans aucun setup X11 forwarding.
- 05
Intégration CI/CD
GET /terminal/result/{id}Lance des étapes de build, exécute des tests, déploie des artefacts — tout en HTTP. Intègre Terminal dans n'importe quelle pipeline CI avec de simples appels curl et des réponses JSON structurées.
- 06
Monitoring live
GET /system/resourcesStats CPU, mémoire, disque et réseau en temps réel via API. Listez les processus en cours, envoyez des signaux, inspectez les ports — visibilité système totale via des endpoints structurés.
Prêt à explorer ?
Terminal est l'un des 18 services Kit livrés avec chaque conteneur Hoody. Aucune installation, aucune configuration — explorez la doc ou parcourez la référence API ci-dessus.