Farbthema

Fehlerbehandlung

Eranio

Fehlerbehandlung

Statuscodes

Code Wann
200 Normale Antwort, auch bei fehlgeschlagenen Aktionen (siehe unten)
204 CORS-Vorabanfrage
400 Pflichtfeld fehlt (Banns, Stummschaltungen, Chat, Rechte)
403 Token fehlt oder ist falsch
404 Unbekannte Route oder Aktion
405 Falsche HTTP-Methode

success und error

Aktionen antworten mit HTTP 200 und melden das Ergebnis im Inhalt. Immer success prüfen:

{
  "success": false,
  "error": "Players are still in this world, send them elsewhere first"
}

Erfolgreiche Aktionen liefern "success": true und Details, zum Beispiel:

{
  "success": true,
  "world": "farmwelt",
  "seed": "1791895563466",
  "warps_moved": 2
}

Typische Fehler

Fehler Ursache
Player not online Der Spieler muss für diese Aktion online sein
World not loaded Welt zuerst laden oder zurücklegen
This is the default world, set another default world first Die Standardwelt lässt sich nicht entladen oder zurücksetzen
Invalid name (a-z, 0-9, _ and -, 2 to 32 characters) Namensregel für Welten
Unknown weather Die Wetter-ID gibt es in Hytale nicht

Unerwartete Ausnahmen landen mit dem Handler-Namen in der Serverkonsole und kommen als "error": "Internal error: ..." zurück.