AWS - Parameter für Anträge und Anfragen - Teil II

Webservice - Parameter für Request und Response

Um beim Webservice eine erfolgreiche Anfrage an den Amazon Webserver zu stellen, reicht die eigentliche URL und der erste Teil des QueryStrings mit dem Zugangsschlüssel und der Partnererkennung (wie auf der vorausgehenden Seite beschrieben) noch nicht aus. Es fehlen noch wesentliche Parameter für die eigentliche Fragestellung. Doch wie könnte eine Fragestellung aussehen und aus welchen Parametern könnte sich diese Anfrage zusammen setzen?

Bei der Beantwortung dieser Frage hilft eventuell ein Vergleich mit dem realen Leben ein wenig weiter. Wer in einem Supermarkt geht, der hat in der Regel bereits vorher klarer Vorstellung darüber, was er kaufen möchte. Dazu gehört unter anderem eine Vorstellung darüber, in welcher Abteilung er oder sie den Artikel am wahrscheinlichsten finden könnte und eine Reihe weiterer Aspekte. Amazon ist vom Prinzip her ebenso ein riesiger Supermarkt, nur halt online. Daraus könnten sich zum Beispiel folgende Parameter für eine Anfrage ergeben.

1. In welcher Kategorie oder Rubrik soll gesucht werden?
2. Wie und nach was soll gesucht werden?
3. Wie umfangreich sollten weitere Informationen zum Produkt sein?
4. Wie viele Produkte sollen auf wie viel Seiten angezeigt werden?

Beispiel: Sie betreiben eine Website zum Thema Zwergkaninchen und möchten Ihren Besuchern entsprechende Literatur empfehlen, ohne ein bestimmtes Buch besonders hervorzuheben. Als ersten Parameter wird hier die gewünschte Operation angegeben, in diesem Fall ItemSearch. Die Operation ItemSearch ermöglicht die Produktdatenbank von Amazon unter Verwendung einer Vielzahl weiterer Angaben zu durchsuchen. Eine Liste weiterer möglicher Operationen finden Sie auf dieser Seite:

» Übersicht - Operationen «

Wenn Sie nun auf der Seite Übersicht - Operationen (The following operations...) dem Linkhinweis ItemSearch folgen, gelangen Sie auf eine Seite, auf der Sie die Beschreibung weiterer möglicher Parameter vorfinden. Mit Hilfe dieser weiteren Parameter lässt sich die angestrebte Anfrage verfeinern, zum Beispiel durch Angabe einer zu durchsuchenden Abteilung im Versandhaus (Rubrik oder Kategorie im Online-Versandhaus). Der zugehörige Parameter trägt den Namen SearchIndex und bedeutet bei der Anfrage soviel wie; "Lieber Server, durchsuche doch bitte die angegebene Rubrik nach einem bestimmten Begriff, Autor oder Titel."

Als mögliche Parameterangaben für den deutsprachigen Raum kommen hier folgende Rubriken oder Kategorien für SearchIndex in Frage: (Stand 2008)

Um beim oben gewählten Beispiel zu bleiben, den Buchempfehlungen passend zur Website und zum Thema Zwergkaninchen, würde hier die Rubrik Books in Frage kommen. Nun fehlt noch der Parameter, der angibt nach was gesucht werden soll. Eine Anfrage nach einem bestimmten Autor oder Verlag würde vermutlich nicht die günstigsten Resultate bringen. Um die Anfrage so weit wie möglich auf Zwergkaninchen einzuschränken, würde es sich anbieten hier nur nach Literatur zu suchen, die sich mit dem Thema Zwergkaninchen beschäftigt. Ermöglicht wird die Suche nach einem bestimmten Begriff durch den Parameter Keywords.

Doch damit sind die Angaben für die Anfrage immer noch nicht komplett. Es fehlt noch ein wichtiger Parameter. Ein Parameter, der dem Server mitteilt, wie umfangreich die Angaben sein sollten. Ob mit Bildern oder ohne, nur mit den nötigsten Angaben oder etwas mehr, hängt letztendlich von den Vorstellungen des Webmasters ab, wie er die Buchempfehlungen zum Thema Zwergkaninchen seinen Besuchern präsentieren möchte. Hier kommt als Parameter die ResponseGroup ins Spiel. Eine Liste mit den Beschreibungen aller zur Verfügung stehenden ResponseGroups finden Sie unter nachfolgendem Linkhinweis.

» ResponseGroups «

Damit wäre der QueryString mit allen dazugehörigen Parametern bereits beinahe komplett. Dennoch ein kleiner Schönheitsfehler bleibt noch. Wer sich einmal auf den Seiten von Amazon umsieht und in der Rubrik Literatur nach Zwergkaninchen sucht, derjenige wird feststellen, dass es über Einhundert Titel zu diesem Thema gibt. Bei einer Anfrage nach diesem Schema werden jedoch nicht mehr als 10 Ergebnisse ausgeliefert. Was tun? Ganz einfach, in einem weiteren Parameter bei der Anfrage dem Server mitteilen, dass er doch bitte schön alle Ergebnisse zum Thema Zwergkaninchen so nach und nach seitenweise übermitteln kann und dabei mit der ersten Seite und den ersten 10 Ergebnissen beginnen sollte. Hier kommt der Parameter ItemPage ins Spiel, wo in diesem Fall 1 für die ersten 10 Ergebnisse steht, 2 für die Ergebnisse 11 bis 20 usw. usf..

Die ganze sich daraus ergebene URL einschließlich des QueryStrings würde dann aussehen wie nachfolgend, wobei die Zeilen auf keinen Fall umgebrochen werden und ebenso keine Leerstellen enthalten dürfen.

http://ecs.amazonaws.de/onca/xml?Service=AWSECommerceService&
AWSAccessKeyId=0XYZ00XYZ0&AssociateTag=ohnephantasie-21&
Operation=ItemSearch&SearchIndex=Books&Keywords=Zwergkaninchen&
ResponseGroup=Medium&ItemPage=1

Achtung: Bitte nicht diese URL einschließlich QueryString ausprobieren, da der Zugangsschlüssel (AWSAccessKeyId) und die Partner-ID (AssociateTag) im Beispiel nur der Phantasie entspringen und erst gegen Ihre Zugangskennungen ausgetauscht werden müssen. Weiterhin sind unbedingt nachfolgende Hinweise zu beachten.

Wichtiger Hinweis: Ab August 2009 müssen die Parameter nach ihrem Byte-Wert in der Reihenfolge sortiert, sowie um einen Zeitstempel (Timestamp) und um eine Signatur erweitert werden.

Weitere Einzelheiten & Codebeispiel

Neben diesen bisher vorgestellten Parametern für den Webservice, gibt es noch eine große Vielzahl weiterer Parameter für Request und Response. Da die Variationsmöglichkeiten jedoch zu umfangreich sind, können wir hier nur auf einige wenige eingehen. Ein weiteres Beispiel möchten wir Ihnen dennoch auf der nächsten Seite nicht vorenthalten.

API, Request und Response « / » Weitere Beispiele| Neuerungen | Signatur

Finden und
gefunden werden ...

Autoritäten im
Internet
Die Kehrseite
Das Wesen

Zukunftsaussichten

Studien & Strategien
Verbreitung & Bedeutung
Internet & Medien

- Optimierung -

Einstieg Optimierung
Erfolg oder Misserfolg

 

Übersicht

Einführung ins Thema

Amazon Web Services
Request und Response
Anfragen und Anträge
Weitere Beispiele
Einfaches Script - Unicode
Einfaches Script - ISO
DOM/XML und Unicode
DOM/XML und ISO
Weitere Einzelheiten

Images/Bilder prüfen