Items

Base: /api/items

Item-Katalog mit Suche und Bildern

Verarbeitung: ItemsHandler

GET /api/items

Items auflisten

Liefert alle Items des laufenden Servers (Hytale 0.7.2: 4008) mit Typ, Name und Bild.

Parameter

Name	Typ	Pflicht	Beschreibung
`q`	string	Nein	Suche in ID und Name (ohne Groß-/Kleinschreibung)
`type`	string	Nein	Typen, durch Komma getrennt: weapon, armor, tool, glider, utility, consumable, block, misc

Antwort-Beispiel

[
  {
    "id": "hytale:sword_iron",
    "name": "Iron Sword",
    "translationKey": "sword_iron",
    "icon": "<base64>",
    "maxStack": 1,
    "maxDurability": 100,
    "itemLevel": 1,
    "consumable": false,
    "dropsOnDeath": true,
    "categories": [
      "weapon"
    ],
    "type": "weapon"
  }
]

cURL

curl -X GET 'http://localhost:5550/api/items?q=sword&type=weapon' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Durchläuft die aktuelle Item-Liste; Bilder werden als base64 zwischengespeichert.

GET /api/items/search

Items suchen

Wie die Liste, für Suchanfragen gedacht.

Parameter

Name	Typ	Pflicht	Beschreibung
`q`	string	Nein	Suchbegriff
`type`	string	Nein	Typfilter wie oben

Antwort-Beispiel

[
  {
    "id": "hytale:sword_iron",
    "name": "Iron Sword",
    "type": "weapon"
  }
]

cURL

curl -X GET 'http://localhost:5550/api/items/search?q=sword&type=weapon' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Nutzt denselben Ablauf wie /api/items.