Zend_Service_Amazon jest prostym API do użycia z web serwisami Amazon. Zend_Service_Amazon ma dwa API: bardziej tradycyjne, które jest oparte na własnym API serwisu Amazon, oraz prostsze API zapytań do łatwego tworzenia nawet skomplikowanych zapytań wyszukiwania. Zend_Service_Amazon pozwala programistom odbierać informacje dostępne na stronach Amazon.com bezpośrednio za pomocą API web serwisów Amazon. Przykłady zawierają: Informacje o przedmiotach, takie jak obrazki, opisy, cenniki i inne Recenzje klientów i redaktorów Podobne produkty i akcesoria Oferty Amazon.com Listy ListMania Aby użyć Zend_Service_Amazon, musisz posiadać klucz API programisty Amazon. Aby otrzymać klucz i zdobyć więcej informacji odwiedź stronę Amazon Web Services. Twój klucz do API serwisu Amazon jest połączony z twoją tożsamością w Amazon, więc staraj się przechowywać twój klucz API bezpiecznie. W tym przykładzie, szukamy książek o PHP w Amazon i przechodzimy przez nie w pętli, wyświetlając je. itemSearch(array('SearchIndex' => 'Books', 'Keywords' => 'php')); foreach ($results as $result) { echo $result->Title .'
'; } ]]> Tutaj także szukamy książek o PHP w Amazon, ale zamiast tradycyjnego API używamy API zapytań, które jest stworzone w oparciu o projektowy wzorzec płynnych interfejsów. category('Books')->Keywords('PHP'); $results = $query->search(); foreach ($results as $result) { echo $result->Title . '
'; } ]]> Domyślnie, Zend_Service_Amazon łączy się z web serwisem Amazon w Stanach Zjednoczonych ("US"). Aby połączyć się z innym krajem, w prosty sposób podaj kod odpowiedniego państwa jako drugi parametr konstruktora: Poprawne kody państw: CA, DE, FR, JP, UK, oraz US. Metoda itemLookup() zapewnia możliwość pobrania informacji o konkretnym przedmiocie, którego ASIN jest znany. itemLookup('B0000A432X'); ]]> Metoda itemLookup() także akceptuje opcjonalny drugi parametr do obsługi opcji wyszukiwania. Aby poznać pełne informacje, włączając w to listę dostępnych opcji odwiedź dokumentację Amazon. Aby odebrać informacje o zdjęciach dla twoich wyników wyszukiwania, musisz ustawić opcję ResponseGroup na Medium lub Large. Wyszukiwanie przedmiotów oparte na różnych dostępnych kryteriach jest przeprowadzane za pomocą metody itemSearch(), tak jak w poniższym przykładzie: itemSearch(array('SearchIndex' => 'Books', 'Keywords' => 'php')); foreach($results as $result) { echo $result->Title .'
'; } ]]> Opcja ResponseGroup używana jest do konfigurowania informacji jakie mają być zwracane w odpowiedzi. itemSearch(array( 'SearchIndex' => 'Books', 'Keywords' => 'php', 'ResponseGroup' => 'Small,ItemAttributes,Images,SalesRank,Reviews,' . 'EditorialReview,Similarities,ListmaniaLists' )); foreach ($results as $result) { echo $result->Title . '
'; } ]]> Metoda itemSearch() akceptuje jeden parametr w postaci tablicy do obsługi opcji wyszukiwania. Aby poznać wszystkie szczegóły włączając w to listę dostępnych opcji, proszę zobacz dokumentację Amazon Klasa Zend_Service_Amazon_Query jest nakładką na tę metodę ułatwiającą tworzenie zapytań wyszukiwania. Zend_Service_Amazon_Query zapewnia alternatywne API do użycia z web serwisami Amazon. Alternatywne API używa wzorca projektowego płynnych interfejsów. Oznacza to, że wszystkie wywołania mogą być przeprowadzone przez łańcuchowe wywołania metod. (np. $obj->method()->method2($arg)) API Zend_Service_Amazon_Query używa przeładowania w celu łatwego ustawiania wyszukiwania przedmiotów i pozwala na wyszukiwanie na podstawie określonych kryteriów. Każda z opcji jest udostępniana jako wywołanie metody, a każdy argument metody odpowiada wartości opcji o tej nazwie: W tym przykładzie alternatywne API zapytań używane jest jako płynny interfejs służący do określania opcji i odpowiadającym im wartościom: Category('Books')->Keywords('PHP'); $results = $query->search(); foreach ($results as $result) { echo $result->Title .'
'; } ]]> To ustawia opcję Category na "Books" oraz Keywords na "PHP". Aby uzyskać więcej informacji o dostępnych opcjach, proszę odwiedź dokumentację Amazon. Poniższe klasy są zwracane przez metody Zend_Service_Amazon::itemLookup() oraz Zend_Service_Amazon::itemSearch(): Zend_Service_Amazon_Item Zend_Service_Amazon_Image Zend_Service_Amazon_ResultSet Zend_Service_Amazon_OfferSet Zend_Service_Amazon_Offer Zend_Service_Amazon_SimilarProduct Zend_Service_Amazon_Accessories Zend_Service_Amazon_CustomerReview Zend_Service_Amazon_EditorialReview Zend_Service_Amazon_ListMania Zend_Service_Amazon_Item jest typem klasy używanej dp reprezentowania przedmiotu Amazon zwracanego przez web serwis. Zawiera ona wszystkie atrybuty przedmiotu, włączając w to tytuł, opis, recenzje itd. string asXML Zwraca oryginalną treść XML dla przedmiotu Zend_Service_Amazon_Item posiada właściwości bezpośrednio związane ze standardowymi częściami Amazon API. Nazwa Typ Opis ASIN string ID przedmiotu w Amazon DetailPageURL string Adres URL strony ze szczegółowymi informacjami o przedmiocie SalesRank int Ranking sprzedaży dla przedmiotu SmallImage Zend_Service_Amazon_Image Małe zdjęcie przedmiotu MediumImage Zend_Service_Amazon_Image Średnie zdjęcie przedmiotu LargeImage Zend_Service_Amazon_Image Duże zdjęcie przedmiotu Subjects array Tematy przedmiotów Offers Zend_Service_Amazon_OfferSet Podsumowanie ofert oraz oferty dla przedmiotu CustomerReviews array Recenzje klientów reprezentowane jako tablica obiektów Zend_Service_Amazon_CustomerReview EditorialReviews array Recenzje redaktorów reprezentowane jako tablica obiektów Zend_Service_Amazon_EditorialReview SimilarProducts array Podobne produkty reprezentowane jako tablica obiektów Zend_Service_Amazon_SimilarProduct Accessories array Akcesoria dla przedmiotu reprezentowane jako tablica obiektów Zend_Service_Amazon_Accessories Tracks array Tablica numerów i nazw utworów dla muzycznych płyt CD oraz DVD ListmaniaLists array Listy Listmania powiązane z przedmiotem jako tablica obiektó∑ Zend_Service_Amazon_ListmainList PromotionalTag string Etykieta promocyjna przedmiotu Powrót do listy klas Zend_Service_Amazon_Image reprezentuje zdalny obraz dla produktu. Nazwa Typ Opis Url Zend_Uri Zdalny adres URL obrazka Height int Wysokość obrazka w pikselach Width int Szerokość obrazka w pikselach Powrót do listy klas Obiekty Zend_Service_Amazon_ResultSet są zwracane przez metodę Zend_Service_Amazon::itemSearch() i pozwalają ci na łatwą obsługę wielu zwróconych wyników wyszukiwania. Implementuje interfejs SeekableIterator dla łatwej iteracji (np. używając foreach), tak samo jak i dla bezpośredniego dostępu do specyficznego wyniku używając metody seek(). int totalResults Zwraca całkowitą ilość wyników zwróconych przez wyszukiwanie Powrót do listy klas Każdy wynik zwracany przez metody Zend_Service_Amazon::itemSearch() oraz Zend_Service_Amazon::itemLookup() zawiera obiekt Zend_Service_Amazon_OfferSet poprzez który dostępne są informacje o cenach dla przedmiotu. Nazwa Typ Opis LowestNewPrice int Najniższa cena dla nowego przedmiotu (stan "New") LowestNewPriceCurrency string Waluta dla LowestNewPrice LowestOldPrice int Najniższa cena dla używanego przedmiotu (stan "Used") LowestOldPriceCurrency string Waluta dla LowestOldPrice TotalNew int Całkowita ilość przedmiotów o stanie "new" TotalUsed int Całkowita ilość przedmiotów o stanie "used" TotalCollectible int Całkowita ilość przedmiotów o stanie "collectible" TotalRefurbished int Całkowita ilość przedmiotów o stanie "refurbished" Offers array Tablica obiektów Zend_Service_Amazon_Offer. Powrót do listy klas Każda oferta dla przedmiotu jest zwracana jako obiekt Zend_Service_Amazon_Offer. Nazwa Typ Opis MerchantId string ID handlowca Amazon GlancePage string Adres URL strony z podsumowaniem handlowca Condition string Stan przedmiotu OfferListingId string ID listy ofert Price int Cena za przedmiot CurrencyCode string Kod waluty dla ceny przedmiotu Availability string Dostępność przedmiotu IsEligibleForSuperSaverShipping boolean Czy przedmiot jest dostępny w Super Saver Shipping czy nie Powrót do listy klas Kiedy wyszukujemy przedmiotów, Amazon także zwraca listę podobnych produktów, które także mogą odpowiadać szukającemu. Każdy z nich jest zwracany jako obiekt Zend_Service_Amazon_SimilarProduct. Każdy obiekt zawiera informacje pozwalające ci na przeprowadzenie kolejnego żądania w celu pobrania pełnych informacji o przedmiocie. Nazwa Typ Opis ASIN string Unikalny ID produktu (ASIN) Title string Tytuł produktu Powrót do listy klas Akcesoria dla zwróconego przedmiotu są reprezentowane jako obiekty Zend_Service_Amazon_Accessories Nazwa Typ Opis ASIN string Unikalny ID produktu Amazon (ASIN) Title string Tytuł produktu Powrót do listy klas Każda recenzja klienta jest zwracana jako obiekt Zend_Service_Amazon_CustomerReview. Nazwa Typ Opis Rating string Ocena przedmiotu HelpfulVotes string Głosy mówiące o tym jak pomocna jest recenzja CustomerId string ID klienta TotalVotes string Całkowiita ilość głosów Date string Data oceny Summary string Podsumowanie oceny Content string Zawartość oceny Powrót do listy klas Każda recenzja redaktora jest zwracana jako obiekt Zend_Service_Amazon_EditorialReview Nazwa Typ Opis Source string Źródło recenzji redaktora Content string Zawartość oceny Powrót do listy klas Wyniki wyszukiwania elementów List Mania są zwracane jako obiekty Zend_Service_Amazon_Listmania. Nazwa Typ Opis ListId string ID listy ListName string Nazwa listy Powrót do listy klas