Účetní programy za nejnižší ceny!
Shopio - efektivní řešení pro Váš e-shop.
Webové služby a gadgety vyhledávače Naakup.cz
V této části jsou popsány naše webové služby a iGoogle gadgety. Pomocí těchto služeb máte jednoduše přístup k našemu vyhledávači i z Vašeho serveru a z Vašich stránek.
Webové služby
Pomocí webových služeb můžete využívat služeb našeho portálu i ve vašich internetových aplikacích nebo ve vašem podnikání. Webové služby Naakup lze např. využít k zapracování našeho vyhledávače zboží do Vašich stránek.
Integrace a portálem Naakup je velmi jednoduchá, struktura a použití webových služeb jsou popsány níže. Webové služby jsou založeny na technologii SOAP (Simple Object Access Protocol).
Před využíváním webových služeb dostanete přidělené vaše jednoznačné ID a heslo. Tyto údaje budete potřebovat během využívání webových služeb.
Pokud chcete získat další informace ohledně webových služeb, potřebujete cokoli vysvětlit atd., neváhejte se na mě obrátit, potřebné kontaktní informace naleznete na stránce Informace o provozovateli. Můžete také využít kontaktní formulář.
Vlastní vyhledávač zboží - zobrazování našich produktů na vašem portálu
Chcete získat nové návštěvníky? Nabídněte jim unikátní funkci na vašem webu!
Provozujete katalog internetových obchodů? Máte webové stránky zaměřené např. na internetový marketing, obchodování nebo podobné téma? Pak by vaši návštěvníci mohli ocenit novou funkci vašich stránek - vyhledávání zboží a porovnávání cen. Můžete tedy na své stránky implementovat vyhledávací formulář, pomocí kterého budou mít vaši návštěvníci možnost vyhledávat zboží z internetových obchodů.
Výhody pro vás
- Zatraktivníte vaše stránky a získáte nové návštěvníky.
- S minimální námahou získáte velmi užitečnou službu pro vaše návštěvníky.
- Neřešíte žádné technické věci ohledně algoritmu vyhledávání, databáze, aktualizace dat atd.
Základní vlastnosti
- Na vašem serveru je umístěn vyhledávací formulář, kam váš uživatel zadává název zboží a další údaje (omezení ceny atd.).
- Na vašem serveru je implementován klient, který se dotazuje našeho vyhledávače na data.
- Data vrácená naším vyhledávačem zobrazujete na svých stránkách - seznam nalezeného zboží, obrázky, odkazy atd.
- Funkce potřebné pro vyhledávání jsou velmi jednoduché na implementaci.
- Zobrazení výsledných dat si můžete libovolně přizpůsobit
Komunikace mezi vaším klientem a naším serverem probíhá pomocí protokolu SOAP, což je standardní protokol pro webové služby. Váš klient může být implementován v libovolném prostředí, které podporuje protokol SOAP - např. PHP, .NET atd. Detailní popis komunikace, struktury dat a příklad klienta je uveden níže.
Ceník služeb
V současné době jsou všechny služby v testovacím provozu a tudíž jsou všechny služby zdarma! Velmi uvítám, pokud budete tyto služby v testovacím provozu využívat a poskytnete mi zpětnou vazbu, s čím jste spokojeni a nespokojeni a co je potřeba změnit a zlepšit.
Podmínkou použití je zveřejnění odkazu na Naakup na vašem serveru a užívání webových služeb v souladu s dohodou (ne např. k dolování dat atd.).
O ukončení testovacího provozu a ceníku služeb vás budu včas informovat.
Vydělávejte s naším vyhledávačem!
Na našem vyhledávači si mohou internetové obchody zaplatit přednostní zobrazování svých produktů ve výsledcích vyhledávání. Tyto produkty se zobrazují před ostatními a jsou placeny formou PPC.
Připravujeme služby, které umožní zobrazovat tyto produkty i na vašem serveru, pokud budete mít implementovaný náš vyhledávač zboží. Z každého kliknutí na takový produkt zobrazený na vašem serveru potom získáte určitou částku. Princip je podobný jako např. u reklamy Etarget, Adsense atd.
Technický popis webové služby
Webové služby jsou implementovány pomocí technologie SOAP 1.2. WSDL soubor popisující poskytované služby je umístěn na http://www.naakup.cz/webservices/searchservice.wsdl.
Všechny vstupní i výstupní texty jsou kódovány v UTF-8, tedy např. i klient na vašich webových stránkách předává naší webové službě požadovaný hledaný výraz v kódování UTF-8 a zpět přijímá texty také v kódování UTF-8.
Váš klient se protokolem SOAP dotáže na ceny určitého zboží, které je v naší databázi. Zboží je zadáno svým názvem, např. Sony Ericsson 510, a dále může být omezeno cenou. Server Naakup vyhledá toto zboží v databázi a zašle klientovi (v definovaném formátu) všechny nalezené produkty pod tímto názvem, včetně cen, textů, odkazů a dalších údajů. Váš klient provede zpracování těchto dat, např. je zobrazí na vašich stránkách.
Služba pro vyhledávání produktů
Tato funkce vyhledá produkty podle zadaného názvu, popř. dalších parametrů.
URL služby: http://www.naakup.cz/webservices/search.php
Operace: searchproducts
Vstupní parametry:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| keyword | string | Vyhledávaný řetězec - název zboží. Zadává se s diakritikou a bez uvozovek. Povinný parametr. |
| priceFrom | decimal | Cena od - vyhledají se jen produkty s vyšší cenou. Volitelný parametr. Pokud parametr nechcete zadávat, vyplníte -1. Cena je s DPH a zadává se s desetinnou tečkou. |
| priceTo | decimal | Cena do - vyhledají se jen produkty s nižší cenou. Volitelný parametr. Pokud parametr nechcete zadávat, vyplníte -1. Cena je s DPH a zadává se s desetinnou tečkou. |
| sortByPrice | int | Třídění výsledků. 0 - třídí se dle relevance, tzn. podle toho které produkty nejlépe vyhovují zadanému názvu. 1 - třídí se dle ceny vzestupně (levnější napřed). -1 - třídí se dle ceny sestupně (dražší napřed). |
| page | int | Stránka. Server vrací nalezené produkty po dvaceti, pokud tedy je nalezeno např. 41 produktů, budete tuto funkci volat postupně třikrát, vždy s parametrem page=1, page=2, page=3 |
| customerID | int | Vaše ID - získáte ho, pokud budete chtít používat webové služby Naakup. Toto ID musí být uvedeno v každém volání vyhledávací funkce. |
| customerPasswd | string | Vaše heslo - získáte ho, pokud budete chtít používat webové služby Naakup. Toto heslo musí být uvedeno v každém volání vyhledávací funkce. |
Výstupní parametry:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| result | array[SearchResult] | Pole deseti vyhledaných produktů. Server vrací nalezené produkty po dvaceti, pokud tedy je nalezeno např. 41 produktů, budete vyhledávací funkci searchproducts volat postupně třikrát, vždy s parametrem page=1, page=2, page=3. Popis SearchResult viz níže. |
| count | int | Celkový počet nalezených produktů. |
| pages | int | Celkový počet stránek. Tento výsledek budete potřebovat, abyste věděli kolikrát máte volat vyhledávací funkci searchproducts. |
| error | string | Chybová hláška, pokud během hledání dojde k nějakým problémům (např. zadáte špatné ID, heslo atd.) |
Struktura výstupního parametru SearchResult:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| id | int | ID produktu dle Naakup.cz |
| name | string | Název produktu |
| price | decimal | Cena produktu bez DPH |
| priceVat | decimal | Cena produktu s DPH |
| description | string | Popis produktu |
| url | string | URL produktu - odkaz na produkt do vyhledávače Naakup |
| eshop | string | Název eshopu |
| eshopUrl | string | URL eshopu - odkaz na eshop do vyhledávače Naakup |
Příklad klienta pro vyhledávání produktů
Zde je uvedený příklad klienta v PHP, který vyhledá všechny produkty s názvem digitální fotoaparát olympus a vypíše získané informace na obrazovku. Limit minimální ceny je 2000, limit maximální ceny není zadán.
Klienta si můžete prohlédnout nebo stáhnout, po stažení si přejmenujte soubor z TXT na PHP a můžete klienta hned použít a libovolně upravovat.
Prohlédnout příklad klienta. Před použitím klienta musíte požádat o přidělení jména a hesla pro přístup k webovým službám!
Služba pro vyhledávání produktů pro přednostní výpisy (PPC)
Tato funkce vyhledá produkty podle zadaného názvu. Jsou vyhledávány pouze produkty, u kterých má internetový obchod nastaveno placené přednostní zobrazování na partnerských serverech.
URL služby: http://www.naakup.cz/webservices/search.php
Operace: searchproductsppc
Vstupní parametry:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| keyword | string | Vyhledávaný řetězec - název zboží. Zadává se s diakritikou a bez uvozovek. Povinný parametr. |
| customerID | int | Vaše ID - získáte ho, pokud budete chtít používat webové služby Naakup. Toto ID musí být uvedeno v každém volání vyhledávací funkce. |
| customerPasswd | string | Vaše heslo - získáte ho, pokud budete chtít používat webové služby Naakup. Toto heslo musí být uvedeno v každém volání vyhledávací funkce. |
Výstupní parametry:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| result | array[SearchResult] | Pole deseti vyhledaných produktů. Server vrací maximálně 10 nalezených PPC produktů. Pořadí produktů je dáno interním algoritmem Naakup, nemůžete ho ovlivnit. |
| count | int | Celkový počet nalezených produktů. |
| error | string | Chybová hláška, pokud během hledání dojde k nějakým problémům (např. zadáte špatné ID, heslo atd.) |
Struktura výstupního parametru SearchResult:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| name | string | Název produktu |
| price | decimal | Cena produktu bez DPH |
| priceVat | decimal | Cena produktu s DPH |
| description | string | Popis produktu |
| url | string | URL produktu - odkaz na produkt přímo do eshopu |
| eshop | string | Název eshopu |
Příklad klienta pro vyhledávání PPC produktů
Zde je uvedený příklad klienta v PHP, který vyhledá všechny PPC produkty s názvem pohoda 2008 a vypíše získané informace na obrazovku.
Klienta si můžete prohlédnout nebo stáhnout, po stažení si přejmenujte soubor z TXT na PHP a můžete klienta hned použít a libovolně upravovat.
Prohlédnout příklad klienta. Před použitím klienta musíte požádat o přidělení jména a hesla pro přístup k webovým službám!
Služba pro získání detailu produktu
Tato funkce vrátí detailní informace o jednom konkrétním produktu dle jeho ID.
URL služby: http://www.naakup.cz/webservices/search.php
Operace: productdetail
Vstupní parametry:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| id | int | ID produktu na Naakup.cz. Povinný parametr. |
| customerID | int | Vaše ID - získáte ho, pokud budete chtít používat webové služby Naakup. Toto ID musí být uvedeno v každém volání vyhledávací funkce. |
| customerPasswd | string | Vaše heslo - získáte ho, pokud budete chtít používat webové služby Naakup. Toto heslo musí být uvedeno v každém volání vyhledávací funkce. |
Výstupní parametry:
| Název parametru | Typ parametru | Popis hodnoty parametru |
|---|---|---|
| name | string | Název produktu |
| price | decimal | Cena produktu bez DPH |
| priceVat | decimal | Cena produktu s DPH |
| description | string | Popis produktu |
| url | string | URL produktu - odkaz přímo do eshopu |
| eshop | string | Název eshopu |
| eshopUrl | string | URL eshopu - odkaz přímo do eshopu |
| error | string | Chybová hláška, pokud během hledání dojde k nějakým problémům (např. zadáte špatné ID, heslo atd.) |
Příklad klienta pro získání detailu produktů
Zde je uvedený příklad klienta v PHP, který získá informace o produktu s konkrétním ID a vypíše získané informace na obsazovku.
Klienta si můžete prohlédnout nebo stáhnout, po stažení si přejmenujte soubor z TXT na PHP a můžete klienta hned použít a libovolně upravovat.
Prohlédnout příklad klienta. Před použitím klienta musíte požádat o přidělení jména a hesla pro přístup k webovým službám!
iGoogle gadget Naakup
Pro přístup k našim službám můžete také použít náš iGoogle gadget, který Vám umožní jednoduše přidat na Vaše stránky náš vyhledávač produktů. Gadget umí hledat zadané produkty, hledání lze omezit cenou a výsledky lze třídit dle ceny nebo relevance. Výsledky je možné zobrazit přímo v gadgetu, nebo je možné nechat si otevřít novou stránku.
Vlastní vyhledávač pomocí iGoogle gadgetu Naakup
Vlastní vyhledávač na Vašich stránkách lze zprovoznit i pomocí našeho iGoogle gadgetu. Implementace je velmi jednoduchá, zabere opravdu jen pár okamžiků, viz postup pod gadgetem.
Nevýhoda gadgetu je v tom že nelze příliš ovlivnit jeho vzhled a chování, gadget nebude designově příliš zapadat do Vašich stránek. Hodí se opravdu jen pro malé weby, které nechtějí vyhledávač zboží více integrovat do svých stránek.
Gadget si můžete přidat na svoji stránku iGoogle pomocí tlačítka +Google pod gadgetem. Gadget si můžete vložit i na vlastní webové stránky pomocí generátoru kódu pro přidávání gadgetů.
;){kind=link}