Ein Blog rund um die Webservices von Amazon & Co

Amazons API – Teil 2 (Der erste Request)

Gepostet von Chris am 21.01.2010 in Amazon API | Keine Kommentare

In diesem Artikel werden wir einen erste Abfrage, einen sogenannten Request, an die API von Amazon abschicken.

Grundsätzlich können Requests in unterschiedlichsten Programmiersprachen getätigt werden (z.B. Java, C#, PERL oder PHP), wir konzentrieren uns in dieser Artikelserie auf den Einsatz von PHP.

Mithilfe eines Request fordern wir die Amazons Product Advertising API auf uns bestimmte Informationen zu übermitteln. Das kann eine Liste von Produkten einer bestimmten Kategorie sein (z.B. alle Bücher mit “Gartengestaltung” im Titel) oder auch detaillierte Informationen zu einem bestimmten Produkt (z.B. Preis, Verfügbarkeit, etc eines speziellen Gartenratgebers).

Dabei funktionieren alle Anfragen nach dem gleichen Schema. Zuerst bauen wird mithilfe von PHP eine Request-URL zusammen und schicken diese dann an die API. Als Antwort erhalten wir dann einen XML-File welchen wir dann für unsere Zwecke weiterverarbeiten.

Die Request-URL im Detail

http://ecs.amazonaws.de/onca/xml?AWSAccessKeyId=DEINE_ACCESS_KEY_ID&amp;
Keywords=garten%20feng%20shui&amp;Operation=ItemSearch&amp;
SearchIndex=Books&amp;Service=AWSECommerceService&amp;
Timestamp=2010-01-21T09%3A17%3A58.000Z&amp;
Version=2009-03-31&amp;
Signature=eh9OfOGrP7hVbhSlGCzQohI%2FYT0nLZedzGjyIrO0CVU%3D

Sehen wir uns die einzelnen Parameter dieser Anfrage doch einmal genauer an:

http://ecs.amazonaws.de/onca/xml?

Dies ist sozusagen die “Grund-URL” an die der Request gesendet wurde. Abhängig davon von welchem Amazon-Shop (de, us, uk, jp, etc.) wir unsere Ergebnisse erhalten möchten (sogenannte Locales), ändert sich diese URL entsprechend.
Übersicht Grund-URLs

AWSAccessKeyId=DEINE_ACCESS_KEY_ID

die Access Key Id (siehe Teil 1 der Artikelserie)

Keywords=garten%20feng%20shui

der Suchbegriff für die Anfrage (%20 steht hierbei für ein Leerzeichen)

Operation=ItemSearch

der Operation-Parameter legt fest, welche Art von Suche wir durchführen wollen. In diesem Fall eine Produktsuche. Es gibt unterschiedliche Operationstypen die verschiedene Ergebnisse zur Folge haben.
Übersicht Operationstypen

SearchIndex=Books

der SearchIndex legt fest in welcher Kategorie der festgelegte Operationstyp durchgeführt werden soll. Hier also in der Kategorie “Bücher”.
Übersicht Kategorien

Die übrigen drei Parameter dienen dazu einen validen (gültigen) Request durchzuführen. Wie diese zustande kommen, zeige ich in einem der folgenden Artikel dieser Serie.

Alle die selbst testen wollen wie so eine Suchanfrage funktioniert bzw. aufgebaut ist, finden bei Amazon den Signed Request Helper. Nach Eingabe der Access Key ID, des Secret Access Key und eines Request-URLs wird eine valide, signierte URL generiert (ganz unten), die man dann einfach in einem Browser (z.B. Firefox) in die Adressleiste kopiert. Als Ergebnis erhält man dann eine XML-Datei.

So kann man sich schon einmal ein Bild davon machen wie die XML-Datei aufgebaut ist.