Ryzom API/Gilden

Aus EnzyklopAtys

< Ryzom API
Version vom 27. Mai 2023, 10:53 Uhr von Leda (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „<noinclude>{{Trad|DE=Ryzom API/Gilden|EN=Ryzom API/Guilds|palette=api |H=1}}__TOC__</noinclude> Zeigt die Liste aller Gilden an. === Verwendung === <base URL…“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche
de:Ryzom API/Gilden en:Ryzom API/Guilds
 
UnderConstruction.png
Übersetzung zur Überprüfung
Gib nicht den Mitwirkenden die Schuld, sondern komm und hilf ihnen. 😎

Zeigt die Liste aller Gilden an.

Verwendung

<base URL>/guilds.php

Cache-Laufzeit

Das zurückgegebene XML enthält das Element <cache> mit den Attributen created und expire (utc timestamp)

XML-Struktur

<guilds>
  <cache created="1387371064" expire="1387374664"/>
  <shard>atys</shard>
  <guild>
    <gid>105906182</gid>
    <name>Atrium</name>
    <race>Fyros</race>
    <icon>575080624687965565</icon>
    <creation_date>131736955</creation_date>
    <description>Hier bist du der Hüter, dein Schicksal ist es, die Regeln zu machen, die eingehalten werden müssen.</description>
  </guild>
  <guild>
    ....
  </guild>
</guilds>

PHP-Interface

ryzom_guildlist_api()

Die Funktion gibt bei Erfolg ein SimpleXMLElement-Objekt oder bei einem Fehler ein boolesches false zurück.

<?php
  require_once "ryzomapi_lite.php";

  $guilds = ryzom_guildlist_api();
  if ($guilds !== false) {
    echo '<pre>';
    foreach($guilds->guild as $guild) {
      $gid = (int)$guild->gid;
      $name = htmlspecialchars($guild->name);
      echo "{$gid} {$name}\n";
    }
    echo '</pre>';
  } else {
    echo "API failure";