Przykłady zastosowania API Nokaut.pl

Grupa Nokaut S.A.
ul. Sportowa 8 bud.B
81-300 Gdynia
infolinia
telefon
e-mail
801 000 410
58 699 29 12
[email protected]
Przykłady zastosowania API Nokaut.pl
1. Przykład wyświetlania najniższej ceny produktu.
2. Przykład wyświetlenia specyfikacji produktu
3. Tworzenie serwisów na podstawie API Nokaut.pl - drzewo kategorii
4. Tworzenie serwisów na podstawie API Nokaut.pl - produkty w wybranej kategorii
1. Przykład wyświetlania najniższej ceny produktu
Jeśli prowadzisz stronę internetową, na łamach której przedstawiasz recenzje, testy, opisy
produktów, możesz wzbogacić swoją treść o aktualne ceny korzystając z informacji
udostępnianych przez porównywarkę cen Nokaut.pl w ramach API.
Aby wyświetlić odpowiednią cenę, skorzystaj z metody nokaut.Product.getById
lub dowolnej innej metody nokaut.Product, w zależności od tego, jakimi danymi o produkcie i ich
stopniem zgodności z Nokaut.pl dysponujesz.
Podpowiedź: ID produktu w Nokaut.pl znajdziesz w źródle strony produktu jako id elementu h1.
W tym przykładzie posłużymy się najniższą ceną znalezioną wśród sklepów, które oferują ten
produkt. Podamy cenę, nazwę w Nokaut oraz Link Partnerski, który dla czytelników Twojej strony
będzie wyglądał podobnie jak ten na poniższej ilustracji:
http://api.nokaut.pl/?
format=xml&key=TU_PODAJ_TWOJ_KLUCZ_API&method=nokaut.Product.getById&id=7876560
26429481828
Wklej powyższy link w pasku adresu oraz wstaw Twój klucz API. Aby pozyskać klucz API,
zarejestruj się jako partner Nokaut.pl. Zobaczysz zawartość pliku XML. Opis poszczególnych
tagów zwracanych w tym XML znajdziesz na stronie http://www.nokaut.pl/ApiDoc
Kod PHP, który możesz użyć na swojej stronie:
$pid=TU_PODAJ_TWOJ_ID_PARTNERA;
$cid=TU_PODAJ_ID_KANAŁU;
$api_key=TU_PODAJ_TWOJ_KLUCZ_API;
$filename = 'http://api.nokaut.pl/?format=xml&key='.
$api_key.'&method=nokaut.Product.getById&id=TU_PODAJ_ID_PRODUKTU';
$xml_obj = simplexml_load_file($filename);
$item = $xml_obj->items->item[0];
$name = $item->name;
$price_min = $item->price_min;
$url = $item->url;
echo '<a href="'.$url.'#pid='.$pid.'&amp;cid='.$cid.'" title="'.
$name.'">Najniższa cena '.$name.' znaleziona na Nokaut.pl to '.
$price_min.'</a>';
Podpowiedź: Więcej o funkcji simplexml_load_file znajdziesz na stronie
http://pl.php.net/manual/pl/function.simplexml-load-file.php
Aby skorzystać z możliwości zarabiania w Programie Partnerskim Nokaut.pl, do adresu URL po #
dodaj swoje numery PID i CID aby stworzyć Link Partnerski
Podpowiedź: Parametr pid pobierzesz generując Link Partnerski w panelu. Parametr cid nie jest
wymagany. Więcej na temat Linków Partnerskich znajdziesz w FAQ na stronie:
http://www.nokaut.pl/partnerzy/faq.html
Podpowiedź: Ponieważ wszystkie metody nokaut.Produkt zwracają identyczny XML, powyższy
kod możesz zastosować również do produktu wyszukanego po kodzie EAN czy nazwie produktu.
2. Przykład wyświetlenia specyfikacji produktu
Jeśli jesteś Partnerem Nokaut.pl, możesz skorzystać ze wszystkich informacji o produkcie jakie
posiada Nokaut.pl w celu wzbogacenia swojej strony. Poniżej przestawiamy gotowy kod który
możesz użyć - jego działanie da efekt podobny jak na poniższej ilustracji:
$api_key=TU_PODAJ_TWOJ_KLUCZ_API;
$filename = 'http://api.nokaut.pl/?format=xml&key='.
$api_key.'&method=nokaut.Product.getById&id=TU_PODAJ_ID_PRODUKTU' ;
$xml_obj = simplexml_load_file($filename);
$item = $xml_obj->items->item[0];
echo '<table>';
foreach($xml_obj ->items->item->properties->property as $property){
$title = $property -> title;
foreach($property->values as $values){
if ($values->item!='brak danych') {
echo '<tr><td>'.$title.'</td>';
$values = (array)$values;
echo '<td>'.implode(', ', (array)$values['item']).'</td></tr>';
}
}
}
echo '<table>';
Pamiętaj - zgodnie z regulaminem, wszędzie tam, gdzie korzystasz z API Nokaut.pl jesteś
zobowiązany podać link do Nokaut.pl, najlepiej jako Twój Link Partnerski.
3. Tworzenie serwisów na podstawie API Nokaut.pl drzewo kategorii
Korzystając z API Nokaut.pl możesz od podstaw stworzyć serwis internetowy będący
porównywarką cen lub dowolny inny serwis, w którym wykorzystasz treści z Nokaut.pl. W tym
przykładzie pokażemy Ci jak stworzyć listę kategorii nadrzędnych, która może stać się głównym
elementem strony startowej Twojego serwisu.
Kategorie nadrzędne mają wartość klucza parent_id równą 0, wykorzystamy to stosując metodę
nokaut.Category.getByParentId
Stwórz plik kategorie.php i skopiuj do niego poniższy kod:
$api_key=TU_PODAJ_TWOJ_KLUCZ_API;
if (isset($_GET['id'])){
$parent_id=$_GET['id'];
} else {
$parent_id=0;
}
$filename = 'http://api.nokaut.pl/?format=xml&key='.
$api_key.'&method=nokaut.Category.getByParentId&parent_id='.
$parent_id.'';
$xml_obj = simplexml_load_file($filename);
foreach($xml_obj ->items->item as $item){
$id = $item->id;
$name = $item->name;
echo '<a href="kategorie.php?id='.$id.'" title="'.$name.'">'.
$name.'</a><br />';
}
Efekt działania tego kodu to lista linków w drzewie kategorii. Dzięki zastosowaniu zmiennej
$parent_id dodatkowo powstał układ katalogów i nawigacja w Twoim serwisie.
4. Tworzenie serwisów na podstawie API Nokaut.pl produkty w wybranej kategorii
Znając ID kategorii, które pozyskasz korzystając z poprzedniego przykładu, możesz stworzyć
stronę będącą listą produktów w tej kategorii. W poniższym przykładzie wykorzystamy metodę
nokaut.Product.getByCategory do wyświetlenia listy produktów oraz metodę
nokaut.Category.getAll do pozyskania nazwy kategorii, której ID przekazujemy jako parametr w
adresie URL.
Poniższy kod możesz wkleić do pliku kategorie.php z poprzedniego przykładu:
$api_key=TU_PODAJ_TWOJ_KLUCZ_API;
$filename = 'http://api.nokaut.pl/?format=xml&key='.
$api_key.'&method=nokaut.Category.getAll';
$xml_obj = simplexml_load_file($filename);
foreach($xml_obj ->items->item as $item){
if ($item->id==$parent_id) {
$category_name = $item->name;
}
}
echo '<h2>Produkty w kategorii '.$category_name.':</h2>';
$filename = 'http://api.nokaut.pl/?format=xml&key='.
$api_key.'&method=nokaut.Product.getByCategory&category='.
$parent_id.'';
$xml_obj = simplexml_load_file($filename);
foreach($xml_obj ->items->item as $item){
$id = $item->id;
$name = $item->name;
$shop_count = $item-> shop_count;
$price_min = $item-> price_min;
$price_max = $item-> price_max;
$url = $item-> url;
echo '<a href="'.
$url.'#pid=TU_PODAJ_TWOJ_PID&amp;cid=TU_PODAJ_ID_KANAŁU" title="'.
$name.'">'.$name.'</a> w '.$shop_count.' sklepach w cenie od '.
$price_min.' zł do '.$price_max.' zł<br />';
}
Podając jako parametr id=633 w adresie URL do swojego pliku, na ekranie uzyskasz treść
podobną do przedstawionej na ilustracji poniżej:
Podpowiedź: W powyższym przykładzie nazwy produktów są linkami do odpowiednich stron
produktowych w Nokaut.pl w postaci Twojego Linku Partnerskiego. Możesz oczywiście stworzyć
własne strony produktów, a dzięki metodom nokaut.Price podawać ceny w sklepach i w ten
sposób stworzyć własną porównywarkę cen. Zachęcamy!