Public Beta

Hytale Hub API

Nutze unsere REST API um Hytale Server Daten abzufragen. Perfekt für Discord Bots, Server Widgets und Status-Seiten.

Übersicht

Unsere API ist darauf ausgelegt, einfach und schnell Server-Metadaten und Vote-Statistiken bereitzustellen. Alle Endpunkte sind read-only und öffentlich zugänglich via HTTPS.
Aktuelle Version: v1 (stabil). Breaking changes werden angekündigt.

Basis URL

https://www.hytale-hub.de/api/public

Response Format

JSON (UTF-8)

Caching

CDN Edge Cache (60s TTL)

Rate Limit

60 req / min (pro IP)

Für Discord-Bots reicht 60–120s Polling völlig. Bitte nicht öfter als 1x/Minute pro Server.

Fair Use & Terms:

Kein Massenscraping der gesamten Datenbank.
Keine Weitergabe der Daten als eigenes Directory ohne Attribution.
Bei intensiver Nutzung (z.B. große Bots) kontaktiere uns bitte vorab.

Wie finde ich den "Slug"?

Der Slug ist der eindeutige Identifier eines Servers und steht in der URL nach /server/.

URL: hytale-hub.de/server/meinsuper-server
Slug: meinsuper-server

Endpunkte

GET/servers/[slug]

Gibt allgemeine Informationen über einen Server zurück (Name, Beschreibung, Tags, Region, IP).

bash

curl https://www.hytale-hub.de/api/public/servers/mein-server

Response Example:

json

{
  "data": {
    "id": "123-abc",
    "name": "Mein Server",
    "slug": "mein-server",
    "region": "DE",
    "ip": "play.example.com",
    "votes": { "today": 5, "total": 120 }
  }
}

GET/servers

Gibt eine paginierte Liste aller Server zurück.

?limit=20?offset=0?region=DE?mode=Survival?tag=Vanilla

bash

curl "https://www.hytale-hub.de/api/public/servers?limit=5&region=DE"

Response Example:

json

{
  "data": [
    { "id": "123", "name": "Server A", ... },
    { "id": "456", "name": "Server B", ... }
  ],
  "meta": {
    "total": 50,
    "limit": 5,
    "offset": 0
  }
}

GET/servers/[slug]/stats

Gibt die aktuellen Vote-Zahlen (Heute/Gesamt) und das letzte Update-Datum zurück.

bash

curl https://www.hytale-hub.de/api/public/servers/mein-server/stats

Response Example:

json

{
  "id": "123-abc",
  "votes": {
    "today": 5,
    "total": 120
  },
  "last_updated": "2024-..."
}

GET/servers/[slug]/embed

Ein optimiertes Payload für Discord Embeds und Widgets. Enthält bereits formatierte Felder und Bild-URLs.

bash

curl https://www.hytale-hub.de/api/public/servers/mein-server/embed

Response Example:

json

{
  "title": "Mein Hytale Server",
  "description": "Short description...",
  "url": "https://www.hytale-hub.de/server/...",
  "fields": [
    { "name": "Votes Heute", "value": "5", "inline": true }
  ]
}

Fehler-Codes

Code	Bedeutung
404	Slug existiert nicht oder Server wurde gelöscht.
400	Ungültiges Format oder fehlende Parameter.
429	Rate Limit überschritten. Bitte Requests cachen.
500	Interner Fehler. Bitte kurz warten oder Support kontaktieren.

Integration in Discord.js

Nutze den Embed-Endpunkt, um mit minimalem Aufwand einen Server-Status Befehl zu bauen.

javascript

const response = await fetch('https://www.hytale-hub.de/api/public/servers/' + serverId + '/embed');
const embedData = await response.json();

// Discord.js v14
await interaction.reply({ embeds: [embedData] });

API Status

Uptime99.9%

Latenz~45ms

Gehostet in Europa (Frankfurt).
Powered by Vercel Edge.

Hosting gesucht?

Anzeige: Wir empfehlen unseren Partner Nitrado. Einfaches Setup und gute Latenz (je nach Standort).

Nitrado Server mieten

Hilfe & Support

Fragen zur API oder Integration? Unser Team hilft dir gerne weiter.

Discord beitreten