Développeurs Hostwolf Apps
Construire sur Hostwolf Apps
Tout ce que vous faites dans la console, vous pouvez le faire depuis votre code : créer des apps à partir de git, d’un Dockerfile ou d’une image, les déployer, lire leurs journaux, définir des variables, ajouter des bases de données managées et activer la mise à l’échelle automatique.
Obtenir un jeton d’API#
- Connectez-vous à la console et ouvrez Clés et jetons → Jetons d’API.
- Saisissez une description, choisissez la durée de validité du jeton et cochez ses permissions.
- Cliquez sur Créer un jeton et copiez-le. Il ressemble à
12|aBcD…et n’est affiché qu’une seule fois.
| Permission | Ce qu’elle autorise |
|---|---|
| Lecture | Lister et lire les projets, apps, déploiements, serveurs, bases de données et réglages. Les valeurs secrètes sont masquées. |
| Lecture des données sensibles | Lire aussi les journaux des apps, les valeurs des variables et les URL de connexion aux bases de données. |
| Écriture | Créer, modifier et supprimer des projets, des apps, des variables, des volumes et des bases de données. |
| Déploiement | Déployer, démarrer, arrêter et redémarrer des apps, y compris via les webhooks de déploiement. |
| Root | Tout ce qui précède. À éviter pour les scripts et les assistants. |
- Un jeton appartient à l’équipe dans laquelle vous étiez au moment de sa création, et ne voit que les ressources de cette équipe.
- Les membres de l’équipe (ni administrateurs ni propriétaires) ne peuvent créer que des jetons Lecture.
- Pour un script qui déploie, cochez Lecture, Écriture et Déploiement. N’ajoutez Lecture des données sensibles que s’il a besoin des journaux ou des secrets.
- Les jetons ne peuvent ni acheter ni résilier de serveurs. La facturation reste dans la console, et les offres sont listées sur la page tarifs.
- Utilisez un jeton par script ou par assistant, pour pouvoir en révoquer un sans casser les autres.
Démarrage rapide#
Envoyez le jeton sous la forme Authorization: Bearer <token> à https://console.app.hostwolf.net/api/v1 :
curl
# Your apps
curl https://console.app.hostwolf.net/api/v1/applications \
-H "Authorization: Bearer $HOSTWOLF_APPS_TOKEN" \
-H "Accept: application/json"
# Deploy one
curl -X POST https://console.app.hostwolf.net/api/v1/applications//start \
-H "Authorization: Bearer $HOSTWOLF_APPS_TOKEN" TypeScript
npm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgzimport { HostwolfApps } from '@hostwolf/apps-sdk';
const hw = new HostwolfApps({ token: process.env.HOSTWOLF_APPS_TOKEN! });
const [app] = await hw.applications.list();
const deployment = await hw.deployAndWait(app.uuid);
console.log(deployment.status, await hw.applications.logs(app.uuid, { lines: 20 }));Assistant IA (MCP)
claude mcp add --transport http hostwolf-apps https://app.hostwolf.net/mcp --header "Authorization: Bearer your_token"Demandez ensuite : « Pourquoi le dernier déploiement de ma boutique a-t-il échoué ? Corrige la commande de démarrage et redéploie-la. » C’est le serveur hébergé sur https://app.hostwolf.net/mcp, sans rien à installer. Voir la configuration MCP pour Claude Desktop, Cursor et VS Code, ou pour le lancer vous-même.
Le démarrage rapide pas à pas déploie une app depuis GitHub avec seulement curl.
Ce que vous pouvez construire#
Téléchargements#
Le SDK et le serveur MCP sont servis depuis app.hostwolf.net, et non depuis le registre npm. Aucune inscription n’est nécessaire, et chaque version a une URL fixe :
| Paquet | Installation |
|---|---|
| SDK TypeScript | npm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgz |
| Serveur MCP | npx -y https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz |
/dl/index.json liste les versions actuelles avec leurs empreintes SHA-256 et d’intégrité npm. La description OpenAPI 3.1 de l’API se trouve à /developers/openapi.json, pour les générateurs de code et les clients d’API.