> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Hytale WebServer ve Query

> Hytale sunucu bilgilerini WebServer üzerinden sorgulanabilir hale getirin.

WebServer, Hytale içinde web hizmetini açar; Query bu hizmetten sunucu adı, sürüm ve oyuncu bilgilerini sunar. Query için iki eklenti de kurulmalıdır.

## Eklentileri kurun

[Nitrado WebServer](https://github.com/nitrado/hytale-plugin-webserver/releases) ve [Nitrado Query](https://github.com/nitrado/hytale-plugin-query/releases) dosyalarını sunucunuzun **mods/** klasörüne yerleştirin. Başlangıç kayıtlarında iki eklentinin de yüklendiğini inceleyin.

## Web portunu hazırlayın

Varsayılan web portu oyun portunun üç fazlasıdır. Örneğin oyun portu **5520** ise web portu **5523** olur. Özel ayarlar **mods/Nitrado\_WebServer/config.json** dosyasındadır.

```json title="Yalnız aynı makinedeki ters vekile açılan örnek" theme={"theme":"css-variables"}
{
  "BindHost": "127.0.0.1",
  "BindPort": 5523
}
```

Bu örnek aynı makinedeki ters vekil için yerel dinleme adresi kullanır. Dış erişim düzenini ve TCP portunu kendi hostinginize göre hazırlayın. WebServer TLS kullanır; istemcinin güveneceği sertifikayı veya ters vekili [yönetici rehberine](https://github.com/nitrado/hytale-plugin-webserver/blob/main/docs/admin/admin-guide.md) göre yapılandırın.

## Query isteğini hazırlayın

```http title="API isteğinin biçimi" theme={"theme":"css-variables"}
GET /Nitrado/Query HTTP/1.1
Accept: application/x.hytale.nitrado.query+json;version=1
```

Yol **/Nitrado/Query** biçimindedir. API istemcisinde sürümlenmiş JSON Accept başlığını kullanın. Tarayıcı aynı adreste HTML görünümü gösterebilir.

## Görünecek bilgileri seçin

**permissions.json** içindeki **Groups.ANONYMOUS** listesine temel görünüm için **nitrado.query.web.read.basic** izni eklenebilir. Oyuncu, eklenti ve diğer ayrıntıların ayrı izinleri vardır; yalnız sunacağınız bilgileri açın.

401/403 yanıtında izinleri, 406 yanıtında Accept başlığını, bağlantı hatasında TLS ve TCP erişimini inceleyin.

[Query API](https://github.com/nitrado/hytale-plugin-query#api-endpoints) · [Komut bağlantısı](https://docs.zonely.gen.tr/integrations/hytale.md) · [Bağlantılar ve araçlar](https://docs.zonely.gen.tr/integrations/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.