API/v2/worlds
Gibt eine Liste der Welten mit ID, lokalisiertem Namen und Bevölkerungsdichte zurück.
Parameter[Bearbeiten]
- allgemeine Anfrageparameter
Antwort[Bearbeiten]
Wenn der Endpunkt ohne Parameter abgefragt wird (/v2/worlds), wird eine Liste aller verfügbaren Welt-IDs zurückgegeben. Wenn mehrere Welten mit dem Parameter ids
angefordert werden, wird ein Array mit mehreren Objekten entsprechend der Anfrage zurückgegeben. Für jede Welt wird ein Objekt mit den folgenden allgemeinen Eigenschaften zurückgegeben:
id
(string) – Die ID der Welt. IDs beginnend mit 1 stehen für amerikanische Welten, IDs beginnend mit 2 stehen für europäische Welten.name
(string) – Der Name in der angegebenen Sprache. Sofern die Sprachzuordnug zutrifft, enthält der Weltname auch ein sprachspezifisches Anhängsel, z.B. [DE].population
(string) - Die Bevölkerungsdichte der Welt. KannMedium
,High
,VeryHigh
oderFull
sein.
- Anmerkung zur ID
Bei den europäischen Welten gibt die 2. Ziffer der ID momentan noch die Sprachzuordnung an, wobei 0 für international, 1 für französisch, 2 für deutsch und 3 für spanisch steht. Während die Zuordnung für die erste Ziffer laut Entwickleraussagen immer bestehen wird, kann sich jedoch die Zuordnung im Bezug auf die 2. Ziffer jederzeit unangekündigt verändern oder vermischen.
Beispiel[Bearbeiten]
https://api.guildwars2.com/v2/worlds?lang=de&ids=2201,2202,2203,2204,2205,2206,2207
[ { "id": 2201, "name": "Kodasch [DE]", "population": "Full" }, { "id": 2202, "name": "Flussufer [DE]", "population": "VeryHigh" }, { "id": 2203, "name": "Elonafels [DE]", "population": "VeryHigh" }, { "id": 2204, "name": "Abaddons Mund [DE]", "population": "VeryHigh" }, { "id": 2205, "name": "Drakkar-See [DE]", "population": "VeryHigh" }, { "id": 2206, "name": "Millersund [DE]", "population": "Medium" }, { "id": 2207, "name": "Dzagonur [DE]", "population": "Medium" } ]