Ryzom API/Gilden

Aus EnzyklopAtys

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";