Zu Handbuch PHP-API

Golem_Api_Special_List – Liste der Special-Kategorien holen

Mit der Klasse Golem_Api_Special_List laden Sie die Liste der Special-Kategorien auf Golem.de.

Einbindung

require_once '[Installationsort/]Golem/Request.php';
require_once '[Installationsort/]Golem/Api/Special/List.php';

Verwendung

Um ein neues Objekt der Klasse Golem_Api_Special_List zu erzeugen, übergeben Sie dem Konstruktor lediglich Ihren Entwicklerschlüssel:

$request = new Golem_Api_Special_List($developerKey);
Beispiel 1: Objektinitialisierung

Die eigentliche Abfrage erfolgt mit der Methode fetch(). War sie erfolgreich, erhalten Sie mit der getSpecials()-Methode die Liste der Kategorien als Array. Jeder Eintrag des Arrays enthält die Daten einer Kategorie in Form eines assoziation Arrays.

$request->fetch();

$specials = $request->getSpecials();
Beispiel 2: Abfrage starten und Daten holen

Fehlerbehandlung

Wenn während der Abfrage ein Fehler auftritt, wird eine Exception geworfen, die Sie mit try-catch auffangen können.

try {

 $request->fetch();

 $specials = $request->getSpecials();

} catch(Exception $e) {

 $error = $e->getErrorCode();

}
Beispiel 3: Fehler abfangen

Verfügbare Kategoriedaten

Für jede Kategorie werden folgende Eigenschaften mitgeliefert:

Name Bedeutung
name Die Bezeichnung der Special-Kategorie
shortname Der Kurzname der Special-Kategorie, wird auch als Identifier der Special-Kategorie benutzt.
url Die URL der Übersichtsseite der Special-Kategorie.

Vollständiges Beispiel

<?php

require_once 'Golem/Request.php';
require_once 'Golem/Api/Special/List.php';

$developerKey = '<ENTWICKLERSCHLÜSSEL>';
$specials     = array();
$error        = '';

$request = new Golem_Api_Special_List($developerKey);

try {

 $request->fetch();

 $specials = $request->getSpecials();

} catch( Exception $e ) {

 $error = $e->getErrorCode();

}

?>

<html>
 <head>
  <title>List of special categories example</title>
 </head>
 <body>
  <?php echo $error; ?>
  <ul>
   <?php

   foreach($specials as $special) {

    echo '<li>';
    echo $special['name'];
    echo '</li>';

   }

   ?>
  </ul>
 </body>
</html>



Zu Handbuch PHP-API