API d’hébergement de jeux : gérer et commander des serveurs

Avec une clé API d’organisation, vos scripts et bots font ce que vous faites sur la page du serveur. La référence complète se trouve dans votre espace client sous Organisation, Développeurs, Serveurs de jeu.

1. Créer une clé#

1. Ouvrez Organisation, Paramètres, Clés API et créez une clé.
2. Choisissez la portée game:read pour lire les serveurs et la console, ou game:write pour aussi les piloter et commander.
3. Copiez la clé (elle commence par org_k_). Elle n’est affichée qu’une fois.

2. Piloter un serveur#

API="https://api.thunderhosting.com/management"

curl -H "Authorization: Bearer org_k_..." \
  $API/api/v1/customer/game-servers

curl -X POST -H "Authorization: Bearer org_k_..." -H "Content-Type: application/json" \
  -d '{"action":"restart"}' \
  $API/api/v1/customer/game-servers/SERVER_ID/power

3. Console : commandes et sortie#

curl -X POST -H "Authorization: Bearer org_k_..." -H "Content-Type: application/json" \
  -d '{"command":"list","waitMs":1500}' \
  $API/api/v1/customer/game-servers/SERVER_ID/command/capture

# {"command":"list","lines":["There are 2 of a max of 20 players online: Alex, Sam"]}

Le point d’accès console renvoie les dernières lignes (jusqu’à 500). Le point d’accès capture envoie une commande et renvoie ce que le serveur a affiché pendant l’attente. Utilisez /command si la sortie ne vous intéresse pas.

4. Commander un serveur avec le solde prépayé#

curl -X POST -H "Authorization: Bearer org_k_..." -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-order-001" \
  -d '{"game":"minecraft-paper","plan":"custom","memoryMb":8192,"cpuPercent":200,
       "diskMb":40960,"eulaAccepted":true,"acceptTerms":true}' \
  $API/api/v1/customer/game-servers/orders

• Rechargez d’abord votre solde prépayé ; la commande est payée immédiatement avec.
• Appelez quote avec le même contenu pour voir le prix avant de commander.
• Si le solde est insuffisant, la réponse est 402 et rien n’est commandé.
• Envoyez un Idempotency-Key pour qu’une requête répétée ne commande jamais deux fois.
• Interrogez ensuite la liste des serveurs avec le subscriptionId reçu jusqu’à ce que le serveur soit ACTIVE.