Desarrolladores

Inicio rápido#

1. Abre Cuenta → Claves API en el panel y crea una clave. Empieza por ptlc_ y solo se muestra una vez.
2. Elige cómo quieres usarlo:

# 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"

Qué puedes crear#

Claves API#

• Envía la clave en cada petición como Authorization: Bearer ptlc_.... Una clave incorrecta, incompleta o revocada recibe 401.
• Una clave puede hacer todo lo que tu cuenta puede hacer en tus servidores. También puede actuar en servidores donde eres subusuario, dentro de los permisos que te dieron allí.
• Revoca claves cuando quieras en la página de claves API.
• Las claves no pueden contratar, cancelar ni pagar servidores. La facturación sigue en el panel, y los planes aparecen en precios.
• Usa una clave distinta para cada aplicación o asistente, así podrás revocar una sin romper las demás.

Lista de IP permitidas#

Al crear una clave puedes limitarla a un máximo de 50 direcciones IP o rangos CIDR, como 203.0.113.7 o 2001:db8::/48. Las peticiones desde cualquier otra dirección reciben 403 con la dirección que vio el panel: This IP address (203.0.113.7) does not have permission to access the API using these credentials.

• Si tu equipo tiene IPv6, el panel suele ver la dirección IPv6, así que permítela también (o un rango que la incluya).
• El servidor MCP alojado llama a la API desde 162.55.180.229. Añade esa dirección a cualquier clave que uses con él.
• Para cambiar la lista, crea una clave nueva y revoca la antigua.

Descargas#

El SDK y el servidor MCP se sirven desde hostwolf.net, no desde el registro de npm. No hace falta registrarse y cada versión tiene una URL fija:

Las versiones actuales y las sumas de verificación están en index.json; lo que ha cambiado está en el registro de cambios.

Límites y buenas prácticas#

Límite de peticiones: 256 peticiones por minuto por cuenta. Algunas acciones tienen su propio límite, más bajo, que se cuenta por separado para cada acción:

Si superas un límite, recibes 429 con una cabecera Retry-After en segundos. El SDK reintenta por ti las esperas cortas e informa de las largas en error.retryAfter.

• Estadísticas: para estadísticas en vivo usa el websocket de la consola en lugar de consultar /resources en un bucle continuo.
• Tareas largas: las copias de seguridad, restauraciones, reinstalaciones e instalaciones de modpacks se ejecutan en segundo plano. Inícialas y vuelve a comprobarlas después. El SDK puede esperar por ti: servers.waitForState(), backups.waitUntilDone() y waitForConsole().

Recursos#