GET /guilds

Endpunkt: GET /v1/pdapi/guilds

Auth: Bearer-Token

Berechtigung: REST.Guilds.Read

Zweck

Listet bekannte Gilden mit Zusammenfassung auf. Nutze diesen Endpunkt, um Gilden-IDs zu finden, bevor du eine bestimmte Gilde abfragst.

Keine.

Keine.

Kein Request-Body.

Feld	Typ	Beschreibung
`Meta`	object	Metadaten der Gildenliste.
`Guilds`	object	Bekannte Gildenzusammenfassungen, nach Gilden-UUID indiziert.

Schema des Meta-Objekts:

Feld	Typ	Beschreibung
`GuildCount`	integer	Anzahl der zurückgegebenen Gilden.

Schema einer Gildenzusammenfassung:

Feld	Typ	Beschreibung
`name`	string	Gildenname.
`Level`	integer	Basislagerstufe der Gilde.
`admin`	object	Details zum Gildenadministrator.
`camp_count`	integer	Anzahl der Basislager der Gilde.
`camps`	object[]	Zusammenfassungen der Basislager.
`member_count`	integer	Anzahl der Gildenmitglieder.
`members`	string[]	PlayerUID-Werte der Gildenmitglieder.

Schema des admin-Objekts:

Feld	Typ	Beschreibung
`id`	string	PlayerUID des Administrators.
`name`	string	Spielername des Administrators.

Schema eines camps[]-Eintrags:

Feld	Typ	Beschreibung
`id`	string	GUID des Basislagers.
`world_pos`	object	Weltkoordinaten des Basislagers.
`map_pos`	object	Umgerechnete Kartenkoordinaten.

Schema des Koordinatenobjekts:

Fehlerantworten verwenden dieses Format:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "Für Menschen lesbare Nachricht",
        "Details": {}
    }
}

HTTP	Fehlercode	Wann es passiert
`401`	`INVALID_TOKEN`	Der `Authorization`-Header fehlt, ist fehlerhaft oder passt zu keinem konfigurierten Bearer-Token.
`403`	`MISSING_PERMISSION`	Das Token ist gültig, enthält aber nicht die Berechtigung für diesen Endpunkt.
`400`	`INVALID_JSON`	Ein Request-Body wurde gesendet, konnte aber nicht als JSON gelesen werden.
`400`	`REQUEST_FAILED`	Der Game-Thread-Callback hat eine Ausnahme ausgelöst oder ein gemeinsamer Spieler-/Ressourcen-Resolver ist fehlgeschlagen.
`500`	`REQUEST_TIMEOUT`	Der interne Game-Thread-Callback wurde nicht innerhalb von 5 Sekunden abgeschlossen.

GET /v1/pdapi/guilds

GET /v1/pdapi/guilds