Développeurs

Démarrage rapide#

1. Ouvrez Compte → Clés API dans le panel et créez une clé. Elle commence par ptlc_ et ne s’affiche qu’une fois.
2. Choisissez comment l’utiliser :

# List your servers
curl https://panel.hostwolf.net/api/client \
  -H "Authorization: Bearer ptlc_your_key" \
  -H "Accept: application/json"

# Restart one (the 8-character id from its panel URL)
curl -X POST https://panel.hostwolf.net/api/client/servers/1a2b3c4d/power \
  -H "Authorization: Bearer ptlc_your_key" \
  -H "Content-Type: application/json" \
  -d '{"signal": "restart"}'

npm install https://hostwolf.net/dl/hostwolf-sdk-0.1.8.tgz

import { Hostwolf } from '@hostwolf/sdk';

const hw = new Hostwolf({ apiKey: process.env.HOSTWOLF_API_KEY! });
const { data: servers } = await hw.servers.list();
await hw.servers.restart(servers[0].identifier);
console.log(await hw.tail(servers[0].identifier, { lines: 20 }));

claude mcp add --transport http hostwolf https://hostwolf.net/mcp --header "Authorization: Bearer ptlc_your_key"

Ce que vous pouvez créer#

Clés API#

• Envoyez la clé dans chaque requête sous la forme Authorization: Bearer ptlc_.... Une clé erronée, incomplète ou révoquée reçoit 401.
• Une clé peut faire tout ce que votre compte peut faire sur vos serveurs. Elle peut aussi agir sur les serveurs dont vous êtes sous-utilisateur, dans la limite des permissions qui vous y ont été données.
• Révoquez vos clés à tout moment sur la page des clés API.
• Les clés ne peuvent pas commander, résilier ou payer des serveurs. La facturation reste dans le panel, et les offres sont listées sur la page tarifs.
• Utilisez une clé distincte pour chaque application ou assistant, afin de pouvoir en révoquer une sans casser les autres.

Liste d’adresses IP autorisées#

Lors de la création d’une clé, vous pouvez la limiter à 50 adresses IP ou plages CIDR au maximum, comme 203.0.113.7 ou 2001:db8::/48. Les requêtes venant de toute autre adresse reçoivent 403 avec l’adresse vue par le panneau : This IP address (203.0.113.7) does not have permission to access the API using these credentials.

• Si votre machine a l’IPv6, le panneau voit généralement l’adresse IPv6 : autorisez-la aussi (ou une plage qui l’inclut).
• Le serveur MCP hébergé appelle l’API depuis 162.55.180.229. Ajoutez cette adresse à toute clé que vous utilisez avec lui.
• Pour modifier la liste, créez une nouvelle clé et révoquez l’ancienne.

Téléchargements#

Le SDK et le serveur MCP sont distribués depuis hostwolf.net, pas depuis le registre npm. Aucune inscription, et chaque version a une URL fixe :

Les versions actuelles et les sommes de contrôle sont dans index.json ; les changements sont dans le journal des modifications.

Limites et bonnes pratiques#

Limite de requêtes : 256 requêtes par minute et par compte. Certaines actions ont leur propre limite, plus basse, comptée séparément pour chaque action :

Au-delà d’une limite, vous recevez 429 avec un en-tête Retry-After en secondes. Le SDK réessaie pour vous après les attentes courtes et signale les plus longues dans error.retryAfter.

• Statistiques : pour les statistiques en direct, utilisez le websocket de la console plutôt que d’interroger /resources en boucle serrée.
• Tâches longues : les sauvegardes, restaurations, réinstallations et installations de modpacks tournent en arrière-plan. Lancez-les, puis revenez vérifier. Le SDK peut attendre pour vous : servers.waitForState(), backups.waitUntilDone() et waitForConsole().

Ressources#