Service KitTerminal
Un shell Linux persistant exposé comme endpoint HTTPS. Exécutez des commandes via API, connectez-vous depuis n'importe quel navigateur, streamez via WebSocket ou connectez-vous directement en SSH. Les sessions persistent entre les reconnexions.
# Obtenez votre token
$ curl https://your-terminal.hoody.com/token
> eyJhbG...
# Exécutez votre première commande
$ curl -X POST .../api/v1/terminal/execute \
-H "Authorization: Bearer $TOKEN" \
-d '["command":"echo Hello from Hoody!","wait":true]'
> ["success":true,"stdout":"Hello from Hoody!\n","duration_ms":3]
# Partagez l'URL — tout le monde peut se connecter
https://proj-dev-terminal-1.server.containers.hoody.com
Cinq façons d'utiliser Terminal
Terminal s'adapte à votre façon de travailler. Exécutez des commandes via HTTP, streamez des builds via WebSocket, collaborez en temps réel, lancez des applications GUI ou surveillez les ressources système — tout depuis la même URL.
Commandes via HTTP
Envoyez une commande shell à n'importe quelle session de terminal. Obtenez un JSON structuré avec stdout, stderr, code de sortie et timing. Pas de tunnel SSH, pas de bibliothèque client — juste HTTP.
# avant / après
- ssh user@server 'ls -la /app' 2>/dev/null
+ curl -X POST terminal.hoody.com/api/v1/terminal/execute -d '["command":"ls -la /app"]'
$ curl -X POST /api/v1/terminal/execute \
-d '["command": "npm test", "wait": true]'
> HTTP/1.1 200 OK
> [
> "success": true,
> "exit_code": 0,
> "stdout": "24 passed, 0 failed",
> "duration_ms": 12
> ]
Chaque commande est un appel API
Envoyez une commande via POST, obtenez un JSON structuré avec stdout, stderr, code de sortie et métadonnées de timing. Synchrone ou asynchrone avec polling.
Voir tous les endpoints# Execute a command via Terminal HTTP API
curl -X POST \
https://proj-dev-terminal-1.hoody.com/api/v1/terminal/execute \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
"command": "ls -la /app",
"wait": true
}'
# Response:
# {
# "success": true,
# "exit_code": 0,
# "stdout": "total 48\ndrwxr-xr-x ...",
# "stderr": "",
# "duration_ms": 12
# }
Conçu pour les vrais workflows
Terminal couvre l'ensemble des scénarios de développement et d'automatisation. Chaque cas d'usage correspond à des endpoints API et des paramètres URL spécifiques.
Développement à distance
Accédez à votre conteneur en SSH depuis n'importe quel appareil avec un navigateur. Accès shell complet avec sessions persistantes — reprenez où vous vous étiez arrêté depuis votre téléphone, tablette ou un autre ordinateur.
Orchestration d'agents IA
Les 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é à l'ensemble de votre environnement de développement.
Débogage en équipe
Partagez une URL de terminal avec votre équipe pour un débogage multijoueur. Tout le monde voit le même résultat, tape des commandes et obtient des couleurs de curseur uniques en temps réel.
Applications GUI
Lancez n'importe quelle application graphique depuis le terminal. Firefox, VS Code, GIMP — terminal-N se mappe automatiquement à display-N sans aucune configuration de transfert X11.
Intégration CI/CD
Exécutez des étapes de build, lancez des tests, déployez des artefacts — tout via HTTP. Intégrez Terminal dans n'importe quel pipeline CI avec de simples appels curl et des réponses JSON structurées.
Surveillance en direct
Statistiques 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 complète via des endpoints structurés.
19 endpoints, contrôle total
Quatre domaines : exécution de commandes, gestion de sessions, streaming en direct via WebSocket et surveillance système. Chaque endpoint retourne du JSON structuré avec authentification par bearer token.
Gestion de sessions
7 endpointscurl .../sessions → [{terminal_id: "1", shell: "bash"}]
Système & méta
6 endpointscurl .../system/resources → {cpu: 45%, mem: 8GB}
Exécution de commandes
4 endpointscurl -X POST .../execute -d '{"command":"npm test"}'
Streaming en direct
2 endpointsWS .../sessions/1/ws → real-time stdout frames
Tout intégré
Chaque fonctionnalité est disponible dès le départ sans aucune configuration. Terminal est prêt à l'emploi dès le démarrage de votre conteneur.
Sessions persistantes
Répertoire de travail, variables d'environnement, historique shell — tout survit à la fermeture du navigateur et aux reconnexions.
Sélection du shell
bash, zsh, fish, tmux, sh — changez de shell via un paramètre URL. Pré-installés et prêts à l'emploi.
Pont tmux
Sessions tmux partagées entre l'accès web et SSH. terminal-3 dans le navigateur correspond à la session tmux 3 via SSH.
Captures d'écran du terminal
Capturez l'état du terminal en PNG, JPEG ou GIF via API. Couleurs et taille de police configurables pour la documentation.
Réinitialisation de session
Arrêtez tous les processus, effacez l'environnement, réinitialisez le répertoire de travail avec un seul paramètre URL. Ardoise vierge instantanément.
Spec OpenAPI
API auto-documentée sur /api/v1/terminal/openapi.json. Générez des clients typés dans n'importe quel langage automatiquement.
Prêt à explorer ?
Terminal est l'un des 14 services Kit fournis avec chaque conteneur Hoody. Aucune installation, aucune configuration — explorez la documentation ou parcourez la référence API ci-dessus.