Hostwolf kehittäjille
Rakenna Hostwolfin päälle
Kaiken, minkä teet ohjauspaneelissa, voit tehdä myös koodista: virta, konsoli, tiedostot, varmuuskopiot, modit ja modipaketit, pelaajat, peliasetukset, ajastukset ja paljon muuta.
Pikaopas#
- Avaa paneelissa Tili → API-avaimet ja luo avain. Se alkaa merkeillä
ptlc_ja näytetään vain kerran. - Valitse, miten haluat käyttää sitä:
curl
# 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"}'TypeScript
npm install https://hostwolf.net/dl/hostwolf-sdk-0.1.8.tgzimport { 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 }));Tekoälyavustaja (MCP)
claude mcp add --transport http hostwolf https://hostwolf.net/mcp --header "Authorization: Bearer ptlc_your_key"Kysy sitten: ”Varmuuskopioi Minecraft-palvelimeni, päivitä Paper uusimpaan versioon ja kerro, jos jokin hajoaa.” Tämä on isännöity palvelin osoitteessa https://hostwolf.net/mcp, eikä mitään tarvitse asentaa. Katso MCP:n käyttöönotto Claude Desktopille, Cursorille ja VS Codelle tai jos haluat ajaa sen itse.
Mitä voit rakentaa#
API-avaimet#
- Lähetä avain jokaisessa pyynnössä muodossa
Authorization: Bearer ptlc_.... Väärä, vajaa tai peruttu avain saa vastauksen401. - Avain voi tehdä palvelimillasi kaiken, mitä tilisi voi. Se voi toimia myös palvelimilla, joilla olet aliakäyttäjä, sinulle siellä annettujen oikeuksien rajoissa.
- Peru avaimia milloin tahansa API-avainten sivulla.
- Avaimilla ei voi tilata, perua tai maksaa palvelimia. Laskutus pysyy paneelissa, ja paketit löytyvät hinnoittelusta.
- Käytä eri avainta jokaiselle sovellukselle tai avustajalle, niin voit perua yhden rikkomatta muita.
Sallittujen IP-osoitteiden lista#
Avainta luodessasi voit rajata sen enintään 50 IP-osoitteeseen tai CIDR-alueeseen, kuten 203.0.113.7 tai 2001:db8::/48. Pyynnöt muista osoitteista saavat vastauksen 403 ja osoitteen, jonka paneeli näki: This IP address (203.0.113.7) does not have permission to access the API using these credentials.
- Jos koneellasi on IPv6, paneeli näkee yleensä IPv6-osoitteen, joten salli myös se (tai sen ympäröivä alue).
- Isännöity MCP-palvelin kutsuu APIa osoitteesta
162.55.180.229. Lisää tämä osoite jokaiseen avaimeen, jota käytät sen kanssa. - Muuttaaksesi listaa luo uusi avain ja peru vanha.
Lataukset#
SDK ja MCP-palvelin jaetaan osoitteesta hostwolf.net eikä npm-rekisteristä. Rekisteröitymistä ei tarvita, ja jokaisella versiolla on kiinteä URL:
| Paketti | Asennus |
|---|---|
| TypeScript-SDK | npm install https://hostwolf.net/dl/hostwolf-sdk-0.1.8.tgz |
| MCP-palvelin | npx -y https://hostwolf.net/dl/hostwolf-mcp-0.1.8.tgz tai isännöity https://hostwolf.net/mcp |
Nykyiset versiot ja tarkistussummat löytyvät tiedostosta index.json; muutokset löytyvät muutoslokista.
Rajat ja hyvät tavat#
Pyyntöraja: 256 pyyntöä minuutissa tiliä kohden. Joillakin toiminnoilla on oma, matalampi rajansa, joka lasketaan erikseen jokaiselle toiminnolle:
| Toiminto | Raja |
|---|---|
| Varmuuskopion luonti | 2 / 10 minuuttia |
| Luo tietokanta | 2 minuutissa |
| Testi-ilmoitukset | 3 minuutissa |
| Peliversion vaihto, modipaketin asennus tai poisto, CS2-kehys | 6 minuutissa kukin |
| Vie tai tuo tietokanta | 6 minuutissa kukin |
| Lisäosan lataus, suositellun lisäosan asennus, verkkotunnuksen tarkistus tai asetus | 10 minuutissa kukin |
| Peliasetusten tai palvelimen ilmoitusasetusten päivitys | 20 minuutissa kukin |
| Muuta tietokannan etäkäyttöä | 20 minuutissa |
| Diagnostiikan ajo | 30 minuutissa |
| Lisäosien tai modipakettien haku | 60 minuutissa kukin |
| Isännöity MCP | 300 pyyntöä minuutissa osoitetta kohden, 180 avainta kohden |
Rajan ylittyessä saat vastauksen 429 ja Retry-After-otsakkeen sekunteina. SDK yrittää lyhyiden odotusten jälkeen puolestasi uudelleen ja ilmoittaa pidemmät kentässä error.retryAfter.
- Tilastot: käytä reaaliaikaisiin tilastoihin konsolin websocketia sen sijaan, että kyselisit
/resources-rajapintaa tiheässä silmukassa. - Pitkät työt: varmuuskopiot, palautukset, uudelleenasennukset ja modipakettien asennukset ajetaan taustalla. Käynnistä ne ja tarkista myöhemmin. SDK voi odottaa puolestasi:
servers.waitForState(),backups.waitUntilDone()jawaitForConsole().