W internecie pojawiła się ostatnio ciekawa propozycja dla wszystkich, którzy często latają w różnych celach. Mowa tutaj o wyszukiwarce lotów Teleportus.

Po wejściu, ukazuje nam się bardzo ładnie zrobiona strona główna na której znajduje się formularz wyszukiwania. Wszystko w jasnych, delikatnych odcieniach niebieskiego koloru, z elementami pomarańczowymi. Pracę z serwisem umila nam smok znajdujący się po lewej stronie formularza

Działanie serwisu jest bardzo proste. W formularzu wskazujemy gdzie chcielibyśmy lecieć, w jakim terminie i jakim celu. Na początek twórcy serwisu dają nam możliwość wybrania trzech aktywności: Wspinania, Odpoczynku na plaży, oraz Zwiedzania. Dodatkowo możemy zdefiniować temperaturę miejsca w które się wybieramy oraz kontynent.

Po zdefiniowaniu parametrów i akceptacji poprzez kliknięcie „SZUKAJ”, pojawia się okienko oczekiwania. Na wyniki czeka się czasem bardzo długo, dlatego też twórcy postanowili umilić nam oczekiwanie pięknymi zdjęciami powiązanymi z wybraną aktywnością. POjawia się również pasek oczekiwania, dzięki któremu wiemy ile czasu zostało do pojawienia się wyników.

Strona z wynikami jest bardzo czytelna. Każda lokalizacja przedstawiony jest jako jeden blok, który rozszerza się po kliknięciu w szczegóły. W szczegółach mamy dodatkowe informacje o aktywności, film oraz mapkę z lokalizacją. Z tego co zauważyłem, serwis prezentuje tylko najniższe wyszukane ceny do danej miejscowości. Dodatkowo, są przynajmniej dwa źródła cen (Tripsta i Esky) dla polskiej wersji serwisu, co znacznie ułatwia nam wyszukanie najtańszego lotu. Jeśli zaś wiemy gdzie dokładnie chcemy lecieć, możemy skorzystać z wyszukiwarki standardowej, gdzie możemy podać wszystkie parametry lotu.

Jak widać, serwis posiada spore możliwości. Samo szukanie jest bardzo proste, ceny które mi akurat się pojawiły były najtańsze z możliwych (sprawdzałem z innymi wyszukiwarkami). Jak tylko pojawi się Nurkowanie w aktywnościach, na pewno się tutaj zjawię aby wyszukać tanie bilety. Póki co Teleportus ląduje w moich ulubionych. Kto wie, może wybiorę się na jakąś ciepłą plażę Za oknem szaro. Trochę słońca by się przydało

Co myślicie o tym sposobie na tanie loty? Mi się bardzo podoba.

Jeśli chcecie sami sprawdzić zapraszam tutaj: http://www.teleportus.pl

W związku, że sezon na narty i snowboard tuż tuż, chciałbym przedstawić możliwości zakupu polisy przez internet. Porównywarki ubezpieczeniowe działają na naszym rynku już sporo czasu. Ostatnio ich popularność znacznie wzrosła i coraz więcej firm oferuje możliwość zakupu polisy ubezpieczeniowej direct.

W naszej recenzji wziąłem na tapetę znaną porównywarkę ubezpieczeń z możliwością zakupu polisy Inseco.pl. Przyjrzałem się dokładnie pod kątem oferty oraz samego procesu zakupu.

Aby przetestować porównywarkę, postanowiłem zakupić dla siebie ubezpieczenie na narty na tydzień czasu w Austrii.

Stroną główna serwisu Inseco.pl jest bardzo przejrzysta. Pojawiają nam się podstawowe informacje związane z serwisem oraz dodatkowe funkcjonalności (np. przypomnienia oraz możliwość kontaktu z Działem Obsługi Klienta). W głównej części znajdują się bloki z możliwością wyboru typu ubezpieczenia. Są wśród nich ubezpieczenia turystyczne, ubezpieczenia mieszkania oraz ubezpieczenia komunikacyjne. Wszystko w bardzo ładnej i przejrzystej grafice.

Po wyborze ubezpieczeń turystycznych pojawia się nam formularz do wypełnienia w którym definiujemy parametry naszego wyjazdu na narty.

Jak widać lista parametrów jest spora i można sobie dowolnie zdefiniować interesujące nas rzeczy. Na szczęście sam formularz nie sprawia kłopotów i jego wypełnienie nie powinno przysparzać problemów. Dla osób które nie bardzo orientują się w tematyce ubezpieczeń serwis oferuje podpowiedzi które w dobry sposób wyjaśniają nasze wątpliwości. Po wypełnieniu formularza pojawia nam się lista ofert które można sortować po cenie oraz zakresie oferowanej ochrony. Dodatkową funkcjonalnością jest możliwość porównania ofert wraz z uwzględnieniem szczegółów (w tym sum ubezpieczenia, zakresu ochrony itp.).

Gdy wybierzemy interesującą nas ofertę, należy wypełnić formularz z danymi o polisy oraz zaakceptować dokumenty potrzebne do realizacji zamówienia. Następnie ostatnią rzeczą która dzieli nas od naszego ubezpieczenia na narty jest płatność za polisę którą można dokonać na wiele sposobów. Do wyboru mamy wiele form płatności które można wykorzystać aby zapłacić za polisę.

Po opłaceniu polisy w ciągu kilku minut (w zależności od formy płatności, w przypadku przelewu może to potrwać dłużej) otrzymujemy SMSa potwierdzającego zakup wraz z numerem polisy. Dodatkowo nasza polisa wysyłana jest do nas na podany adres e-mail, którą można wydrukować i zabrać ze sobą na narty lub snowboard.

Jak widać sam proces zakupu ubezpieczenia na narty zajął mi zaledwie kilka minut.  Pomimo tego, że robiłem to po raz pierwszy nie miałem większych problemów. Wydaje mi się że Inseco.pl jest dobrą propozycją dla osób które cenią sobie czas. Bez wychodzenia z domu i szukania agenta ubezpieczeniowego jesteśmy w stanie kupić polisę w prosty sposób w bardzo krótkim czasie. Jedyną przeszkodą może być brak wiedzy z zakresu ubezpieczeń, dlatego też polecam korzystanie z pomocy oraz czytanie Ogólnych Warunków Ubezpieczenia (OWU)

Aby pomóc osobom w wymyślaniu nazw dla swoich projektów stworzyliśmy prosty generator nazw domen – Blungr.com.

Zasada działania jest bardzo prosta. Wpisujemy jedno lub dwa słowa, wybieramy ustawienia i generujemy nazwę domeny. Interfejs (mam nadzieję) jest bardzo prosty i intuicyjny.  Oto ustawienia które mamy do wyboru:

• domain – nazwa domeny
• prefix – ciąg znaków występujący przed nazwą
• suffix – ciąg znaków występujący po nazwie
• u >> oo – zamiana litery „u” na „oo” (np. „blunger” > „bloonger”)
• i >> oo – zamiana litery „i” na „ee” (np. „trick” > „treeck”)
• r >> er – zamiana ostatniej litery „r” na „er” (np. „blunger” > „blungr”)

Po wygenerowaniu uruchomieniu skryptu, system proponuje nam 7 przykładowych domen. Jeśli wyników jest więcej, resztę można obejrzeć klikając na „Show all”. Następnie mamy możliwość sprawdzenia dostępności domeny poprzez kliknięcie w jej nazwę. Jeśli domena jest dostępna, mamy możliwość zakupu domeny u jednego z dostawców.

Jak widać sam system jest bardzo prosty. Pozwala on jednak na wygenerowanie bardzo ciekawych nazw domen, które na pewno znajdą swoich odbiorców.  Mam nadzieję że pomoże on tym, którzy cierpliwie (tak jak ja wcześniej) spisywali sobie słówka na kartce szukając upragnionej nazwy.

Co dalej?

Algorytm generowania nazw domen jest wciąż rozwijany. Obecnie pracujemy również nad ułatwieniem kupowania samej domeny oraz nad rozszerzeniem ilości obsługiwanych domen. Mamy też wiele innych pomysłów które czekają na realizację. Mamy więc nadzieję że Blungr.com będzie coraz lepszy aby jak najbardziej pomóc użytkownikom w wymyślaniu nazw domen.

Dla wszystkich użytkowników Blungr.com oraz naszych czytelników mamy 10% zniżkę na zakup domeny w firmie Hover.com! Wystarczy kliknąć w poniższy link lub skopiować go do przeglądarki.

http://hover.com/blungr

Życzymy wszystkim ciekawych nazw domen!

Podejrzewam, że teoria zabawy (The Fun Theory) jest już znana większości z Was. Chciałbym jednak napisać kilka zdań na ten temat, ponieważ uważam że jest on warty uwagi.  Zanim jednak to zrobię, proponuję obejrzeć krótki filmik który mniej lub bardziej nawiązuje oraz wyjaśnia samą zasadę nauki poprzez zabawę:

Po tym wyczerpującym wykładzie jedyne co mi pozostaje dodać to fakt, że teoria zabawy polega na nauce lub zmianie ludzkich zachowań poprzez zabawę. Inicjatorem pomysłu jest Volkswagen, który zlecił szwedzkiej firmie DDB Stockholm stworzenie kampani, której celem było wypromowanie nowego typu silników. Powstała więc strona www.thefuntheory.com aby sprawdzić, czy zabawa jest w stanie zmienić zachowania oraz nawyki ludzkie. Kampania okazała się wielkim sukcesem. Filmiki na youtube biły rekordy oglądalności, zaś sam pomysł został zauważony oraz pokazany w wielu stacjach telewizji na całym świecie.

Przykłady

1. Fortepianowe schody

Chyba najbardziej popularny projekt „The Fun Theory”. Film na youtube miał ponad 1,2 mln odtworzeń w zaledwie 4 dni.

2. Najgłębszy kosz na świecie

Tym razem zaledwie 88 tyś odsłon w youtube w 4 dni.

3. Pojemnik na butelki

Jak to się ma do marketingu internetowego?

„The fun theory” pokazuje jak bardzo skuteczne jest wykorzystanie „viral marketingu”. Obecnie w sieci pojawia się bardzo dużo tego typu kampani. Można tutaj wspomnieć o kampani Quicksilver, Ray-Ban (Sunglass catch i Super cameleon) lub Nike Football.

Czy można jednak wykorzystać samą teorię zabawy w marketingu internetowym? W internecie dosyć często spotykamy się z różnego rodzaju grami flashowymi które w formie bannera „zmuszają” nas do kliknięcia w reklamę. Każdy chyba spotkał się ze strzelaniem do kaczek. Intel na swojej stronie prowadził kampanię związaną z F1. Można było zasiąść za kierownicą wirtualnego bolidu formuły 1 i przy okazji wygrać nagrody. Ostatnio z okazji Mistrzostw Świata w RPA firma Allianz uruchomiła grę w typowanie wyników meczów rozgrywanych podczas MŚ2010. Nagrodą było kilkanaście procent zniżki na ubezpieczenie.

Podstawowa jednak różnica między „The fun teory” a tego typu kampaniami jest taka, że w przypadku teorii zabawy mamy do czynienia z poprawą ludzkich zachowań. W tym drugim zabawa wykorzystywana jest tylko i wyłącznie w celach marketingowych. A może Wy natrafiliście w sieci na jakieś przykłady działań które miały wpływ na Wasze zachowanie?

Jak dotrzemy do tych wszystkich projektów / filmów i połączymy je w jedną całość to nagle okazuje się  „wow, to ten facet zrobił tyle fajnych rzeczy,  które pamiętam aż do dziś.”

Chciałbym przedstawić krótki przegląd prac wizjonera-futurysty Syda Meada. Jest tu kilka jego flagowych projektów ale także te mniej znane.  W poniższym poście chciałbym zebrać  te wszytkie ważne (często znane) projekty i przedstawić pod wspólną marką / imieniem, a nie pod sloganem typu „autor motorów z filmu Tron !”

Kontynuując kwestię „motorów” to faktycznie są one chyba najbardziej spektakularnym projektem. Przebiły się w masowej kulturze poprzez koncept arty, film Tron – następnie gry komputerowe, kończąc na projektach wzorujących się na oryginale.

> Lightcycle super-bike z „legendarnego” filmu Tron (Druga część z projektem  super-bike’a opartym na pierwowzorze  wkrótce w kinach). Syd modyfikował także  istniejący design superbike’a  na potrzeby gry PC „Tron” z  roku 2003.

> Spinner Car - kolejny bardzo ważny projekt wykorzystany w filmie  „Blade Runner” – czyli docenionym dopiero po latach klasyku SF na podstawie powieści Philipa . K. Dicka  „Do androids dream about eletric sheeps”. Genialny film, świetne kreacje aktorskie, oraz sugestywny świat. Spinner car był autem startującym pionowo na zasadzie poduszkowca , a następnie przyspieszającym za pomocą silników odrzutowych.  Pojawił się w filmie, a także w grze komputerowej „Blade Runner”  z 1997 r. Oraz kilka razy w znanych filmach na zasadzie rekwizytu.

> Architektura

> Johnny 5 z Krótkiego Spięcia ( Postać Wall-e -ego z filmu Pixara troszkę podobna nieprawdaż?

> statek transportowy Sulaco z filmu Aliens. Projekt znacznie odbiegał o standardowych wizji smukłych statków kosmicznych.  A jak wiemy smukłość nie jest potrzebna w próżni. Bardziej przypominał gigantyczne działo bojowe.

> Wnętrze statku Sulaco

> APC car – Aliens – armored personnel carrier

> Leonov  – Miał swój udział w Odysei kosmicznej 2010 na podstawie powieści  Arthura C. Clarke’a.  Statek kosmiczny Leonov nazwany został na cześć kosmonauty Alexieja Leonova .

Urodzony w1933 roku Syd Mead stworzył wiele wizjonerskich pomysłów. Zanim otworzył własną  firmę pracował jako designer w Ford Motor Company.  Jego vehicle-design z lat 60 tych do tej porą wzbudzają szacunek. A wiele innych jego projektów przebiło się do popkultury. Projektował futurystyczne wnętrza , wehikuły, a nawet zabawki.

Wiele nowych projektów nawiązuje do prac mistrza miedzy innymi wehikuł z „minority report”

Bardziej  popkulturowo – można zobaczyć np lightbike’a  na jednym z wielu t-shirtów Sheldona z serialu Big Bang Theory

projekty „żelaźniaków”  dla  firmy Mattel

> Lego wykonało unikatowy projekt Spinnera  specjalnie dla Syda

Syd Mead pracował także przy takich produkcjach jak Star trek ( v’ger design )  / Wing Commander: Prophecy. ( Conceptual artist ) , Mission to Mars (vehicle design).   Aliens: Colonial Marines ( game )

Strona oficjalna
www.sydmead.com

Jak już wspomniałem w tutorialu dotyczącym dodawania aukcji, jest to bardzo przydatna rzecz, zwłaszcza dla osób które sprzedają przedmioty niewiele się od siebie różniące. Dla niektórych może to też być udogodnienie. Definiowanie samych transakcji w Excelu może być łatwiejsze niż przechodzenie za każdym razem tego samego formularza. Taką funkcjonalność posiada także Google AdWords, który pozwala na zarządzanie słowami kluczowymi kampanii. Obecnie jest to mocno rozbudowany moduł z wbudowanym edytorem Excel, ale kilka lat temu dodawanie słów kluczowych wiązało się z uploadem pliku .csv (lub .xls, już nie pamiętam ;]).

No dobrze. Abyśmy mogli korzystać z funkcjonalności którą Google miało kilka lat temu potrzebujemy samego pliku z definicjami aukcji. Tworzymy więc sobie w Excelu arkusz który będzie zawierał pola wymagane do wystawienia aukcji. Wymagane pola wypisane są w poprzednim poście. Tworzymy więc sobie następujące kolumny w Excelu (aukcje.xls – do pobrania na koniec tutoriala):

• Tytuł
• Kategoria
• Data rozpoczęcia
• Czas trwania aukcji
• Liczba sztuk
• Cena wywoławcza
• Kraj
• Województwo
• Miasto
• Transport
• Formy płatności
• Opis

Wygląd naszego Excela

Gdy mamy już stworzony arkusz, możemy go wypełnić danymi naszych aukcji a następnie wyeksportować dane do pliku .csv. Jako separator pola dajemy „|” a separator tekstu to średnik. Wszystko zapisujemy w formacie UTF-8. Po wyeksportowaniu danych plik będzie wyglądał następująco:

Nasze aukcje w formacie .csv

Skoro mamy już prawie wszystko gotowe, potrzebujemy teraz obsłużyć dany plik i wygenereować na jego podstawie aukcje. Tworzymy więc w tym celu prosty formularz HTML z formatką pliku i jednym przyciskiem. Jako action wskażemy ten sam plik który będzie zarówno wyświetlał formularz i go obsługiwał. W naszym przypadku będzie to plik aukcje.php który będzie wyglądał następująco:

require_once('AllegroAPI.php');

$oAllegro = new AllegroAPI();
$oAllegro->setProperty('conf_countryid', 228);
$oAllegro->setProperty('conf_login', 'test_login');
$oAllegro->setProperty('conf_password', 'test_haslo');
$oAllegro->setProperty('conf_apikey', 'test_klucz');
$oAllegro->connect();
$oAllegro->login();

if($_FILES){
    $oAllegro->uploadAuctions($_FILES['aukcje_plik']['tmp_name']);
}

Oraz fragment kodu HTML odpowiadający za wyświetlenie formularza:

    Plik CSV 

Jak widać wykorzystaliśmy nową metodę z naszej klasy „uploadAuctions()” która zajmuje się przetworzeniem pliku csv i dodawaniem aukcji. Wygląda ona następująco:

public function uploadAuctions($sAuctionsFile){

        $aAuctions = file($sAuctionsFile);

        if(count($aAuctions)>1){
            // pomijamy pierwszy wiersz z nagłówkami
            for ($i=1; $iaddNewAuction($this->prepareAuction(explode("|",$aAuctions[$i])));
            }
            return $i-1;
        } else {
            return false;
        }

    }

Wykonuje ona w pętli metodę „prepareAuction()” która przygotowuje tablicę przekazywaną do metody dodającej nową aukcję. Nie będę tutaj umieszczał całości kodu z klasy ponieważ zajęłoby to zbyt dużo miejsca. Wywołując teraz stronę pod którą umieściliśmy plik aukcje.php powinien pojawić się nam formularz z formatką do wybrania pliku CSV. Po podaniu pliku powinny nam się pojawić nowe aukcje zdefiniowane w tym pliku na naszym koncie. Powinniśmy uważać przy typach pól w excelu i podczas eksportu do csv. Data powinna mieć format YYYY-MM-DD H:i:s, ceny typu float z kropką. Przypominam również że zmieniłem celowo dane autoryzacyjne i klucz API. Jeśli kod z jakiegoś powodu nie działa to proszę o taką informację. W tutorialu nie umieszczam pełnego kodu (jest do ściągnięcia poniżej), więc kopiuj-wklej nie zadziała. Piszę to ponieważ były uwagi do wcześniejszych artykułów że kod nie działa. Jeśli jest tak naprawę to proszę o wskazanie problemu.

Jeszcze jedna drobna sprawa. W tutorialach tych skupiam się tylko na pokazaniu możliwości jakie daje nam WebAPI Allegro. Nie ma więc tutaj jako takiej obsługi błędów i tym podobnych. Dziękuję za wyrozumiałość

Całość kodu dostępna jest tutaj: AllegroAPI3.zip
Skrypt można przetestować wchodząc na http://blog.since78.pl/aukcje.php
Dodane aukcje można zaś śledzić na moim fikcyjnym koncie na testowym webapi: http://www.testwebapi.pl/show_user_auctions.php?uid=17390103

UWAGA:
W związku z tym, że Allegro WebAPI ciągle się zmienia a zmiany niestety nie zawsze są kompatybilne wstecz, przykładowy skrypt oraz klasa do obsługi WebAPI mogą nie działać. Tutorial zamieszczony jest w celu przybliżenia tematu wykorzystania WebAPI w aplikacjach pisanych w PHP. Jakiekolwiek zmiany w specyfikacji od daty umieszczenia tego wpisu nie będą więc uwzględniane.

Pozdrawiam

Dzisiaj proponuję zapoznać się z metodą doNewAuctionExt() która pozwala na dodawani nowej aukcji do serwisu.
Ktoś może sobie pomyśleć – po co dodawać nową aukcję za pomocą WebAPI skoro szybciej i łatwiej dodać ją za pomocą serwisu Allego? Racja. Ale co w przypadku kiedy mamy do sprzedania 40 sztuk jakiegoś przedmiotu który różni się niewielką ilością parametrów? Z pomocą przychodzi nam właśnie metoda doNewAuctionExt().

Zanim jednak zajmiemy się dodawaniem aukcji, założymy sobie konto na testowym Allegro, oraz przygotujemy naszą klasę tak, aby łączyła się z testowym środowiskiem. Założenie konta na testwebapi.pl jest bardzo proste. Najlepiej podać zmyślone dane, które później i tak nie będą nigdzie wykorzystywane (poza adresem e-mail na który wysyłany jest link aktywacyjny oraz oczywiście loginu i hasła do serwisu). Ta również będziemy obserwowali nasze akcje które będziemy wykonywali za pomocą WebAPI. Aby połączyć się z testowym środowiskiem musimy również pozbyć się metody connect() z konstruktora naszej klasy którą pisaliśmy ostatnio. Łączymy się więc wywołując naszą klasę następująco:

$oAllegro = new AllegroAPI();
$oAllegro->setProperty('conf_countryid', 228); // jest to ID dla testwebapi.pl
$oAllegro->setProperty('conf_login', 'login_testwebapi'); // login do testwebapi.pl
$oAllegro->setProperty('conf_password', 'haslo_testwebapi'); // hasło do testwebapi.pl
$oAllegro->connect();

Skoro jesteśmy już połączeni z serwisem testowym, możemy sobie do woli sprawdzać możliwości WebAPI bez zaśmiecania produkcyjnego serwisu. Sprawdźmy więc na co pozwala nam metoda doNewAuctionExt(). Sama metoda przyjmuje cztery parametry:

• session-handle – wymagany – identyfikator sesji (w naszej klasie będzie to $this->id_session)
• fields- wymagany – tablica definiująca parametry aukcji
• private- opcjonalny – czy aukcja ma być prywatna (w polce nie jest już używany, więc możemy przekazać jakąkolwiek wartość)
• local-id – opcjonalny – lokalny identyfikator

Należałoby również wyjaśnić w jaki sposób przekazywać parametry aukcji. Sama lista jest bardzo długa. Można ją wyświetlić za pomocą metody doGetSellFormFieldsExt(). Nie będę tutaj może opisywał wszystkich parametrów. Każdy parametr jest opisywany za pomocą następujących właściwości:

• sell-form-id – identyfikator parametru
• sell-form-title – nazwa parametru
• sell-form-cat – identyfikator kategorii do którego odnosi się parametr (0 oznacza wszystkie kategorie)
• sell-form-type – typ pola które identyfikuje parametr:
  - 1 – string
  - 2 – integer
  - 3 – float
  - 4 – combobox
  - 5 – radiobutton
  - 6 – checkbox
  - 7 – image (base64Binary)
  - 8 – text
  - 9 – datetime (Unix time)
  - 13 – boolean
• sell-form-res-type – wskazanie na typ pola
• sell-form-def-value – wartość domyślna
• sell-form-opt – czy pole jest opcjonalne (1 – nie, 8 – tak)
• sell-form-pos – pozycja w formularzu sprzedaży
• sell-form-length – dopuszczalna ilość znaków
• sell-min-value – minimalna wartość ( dotyczy pól typu combobox/radiobutton/checkbox)
• sell-max-value – maksymalna wartość ( dotyczy pól typu combobox/radiobutton/checkbox)
• sell-form-desc – opis wartości ( dotyczy pól typu combobox/radiobutton/checkbox)
• sell-form-opts-values – wartości ( dotyczy pól typu combobox/radiobutton/checkbox)
• sell-form-field-desc – szczegółowy opis parametru

Wiedząc już sposób w jaki dodawana jest aukcja za pomocą WebAPI jest aukcja, możemy przystąpić do definiowania jej parametrów i wykonania metody dodającej nową aukcję. Aby zdefiniować nową aukcję, potrzebujemy listę parametrów wymaganych. Oto zestawienie parametrów wymaganych oraz opcjonalnych:

Należy jednak pamiętać, aby zdefiniować przynajmniej jedną formę przesyłki. Inaczej WebAPI zwróci nam błąd. Mając już dane których potrzebujemy, możemy zdefiniować sobie przykładową aukcję:
Tytuł: Łożysko kulkowe 5cm
Kategoria: 1885 (Id kategorii Everything Else -> Other)
Data rozpoczęcia: 2010-05-16 23:55
Czas trwania aukcji: 5 (30 dni)
Liczba sztuk: 1
Cena wywoławcza: 30.00 (6)
Kraj: 228 (Neverland )
Województwo: 214 (górnopolskie)
Miasto: Sincity
Transport: 1 (kupujący pokrywa koszty transportu)
Formy płatności: 1 (płatne z góry)
Opis: Szczegółowy opis łożyska kulkowego 5cm

Oczywiście są to dane testowe. Na produkcyjnym serwisie nie znajdziemy Neverlandu. Aby podejrzeć typy oraz wartości które możemy podać, proponuję wylistować sobie te pola używając metody getAuctionFormFields() z naszej klasy:

$oAllegro->getAuctionFormFields();

Tablica definiująca naszą aukcję wyglądałaby więc następująco:

$aAuctionProperties = array(
    array(
        'fid' => 1,   // Tytuł
        'fvalue-string' => 'Łożysko kulkowe 5cm',
        'fvalue-int' => 0,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 2,   // Kategoria
        'fvalue-string' => '',
        'fvalue-int' => 1885,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 3,   // Data rozpoczęcia
        'fvalue-string' => '',
        'fvalue-int' => strtotime("2010-05-16 23:55"),
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 4,   // Czas trwania
        'fvalue-string' => '',
        'fvalue-int' => 4,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 5,   // Ilość sztuk
        'fvalue-string' => '',
        'fvalue-int' => 1,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 6,   // Cena wywoławcza
        'fvalue-string' => '',
        'fvalue-int' => 0,
        'fvalue-float' => 30.00,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 9,   // Kraj
        'fvalue-string' => '',
        'fvalue-int' => 228,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 10,   // Województwo
        'fvalue-string' => '',
        'fvalue-int' => 214,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 11,   // Miasto
        'fvalue-string' => 'Sincity',
        'fvalue-int' => 0,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 12,   // Transport
        'fvalue-string' => '',
        'fvalue-int' => 1,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 14,   // Formy płatności
        'fvalue-string' => '',
        'fvalue-int' => 1,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 24,   // Opis
        'fvalue-string' => 'Szczegółowy opis łożyska kulkowego 5cm',
        'fvalue-int' => 0,
        'fvalue-float' => 0,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    ),
    array(
        'fid' => 36,   // Paczka pocztowa ekonomiczna
        'fvalue-string' => '',
        'fvalue-int' => 0,
        'fvalue-float' => 11.00,
        'fvalue-image' => 0,
        'fvalue-datetime' => 0,
        'fvalue-boolean' => false
    )
);

Mając już zdefiniowaną aukcję, możemy przekazać ją do naszej wcześniej przygotowanej metody addNewAuction(). Wygląda to tak:

$oAllegro->addNewAuction($aAuctionProperties);

Po wywołaniu naszej metody nasza aukcja powinna pojawić się na testowym serwisie testwebapi.pl.
Na dzisiaj to wszystko. Wkrótce pokażę w jaki sposób to wykorzystać na potrzeby automatyzacji wystawiania aukcji.
Oczywiście zaktualizowaną klasę można pobrać stąd: AllegroAPI

UWAGA:
W związku z tym, że Allegro WebAPI ciągle się zmienia a zmiany niestety nie zawsze są kompatybilne wstecz, przykładowy skrypt oraz klasa do obsługi WebAPI mogą nie działać. Tutorial zamieszczony jest w celu przybliżenia tematu wykorzystania WebAPI w aplikacjach pisanych w PHP. Jakiekolwiek zmiany w specyfikacji od daty umieszczenia tego wpisu nie będą więc uwzględniane.

Pozdrawiam.
robert@since78.pl

Samo WebAPI jest oparte na protokole SOAP. Zawiera szereg metod, które w dużej części pokrywają funkcje serwisu. Więcej na ten temat można poczytać w tym miejscu. W trakcie pisania klasy całość była podana w znacznie bardziej toporny sposób. Obecnie strona poświęcona WebAPI przeszła metamorfozę i wszystkie informacje podane są w dużo czytelniejszy sposób.

Aby zacząć zabawę, powinniśmy przede wszystkim posiadać konto w Allegro co pozwoli nam na uzyskanie klucza. Sama usługa dostępna jest w dwóch wersjach: pakiet podstawowy i pakiet profesjonalny. W pakiecie profesjonalnym mamy dostęp do dodatkowych funkcji oraz statystyk wywołania metod i mechanizmu licencjonowania. Niestety wszystko to za dodatkową opłatą 600zł na okres 6 miesięcy. W moim przypadku wystarczył darmowy dostęp.
Aby uzyskać klucz dostępu do Allegro API, należy wysłać żądanie za pomocą formularza kontaktowego. Cały proces przyznania klucza trwał u mnie jeden dzień (w zasadzie na drugi dzień rano miałem już odpowiedź wraz z kluczem).

OK, mając już wszystkie potrzebne rzeczy, możemy zabrać się do korzystania z usług Allegro API. Moim celem było napisanie klasy, która służy do sprawdzania konkretnego ciągu znaków w aukcjach konkretnego użytkownika. Aby móc tego dokonać ogólnie rzecz biorąc potrzebujemy 3 akcji z Allegro API: połączenie, logowanie, pobranie aukcji. Najpierw definiujemy sobie właściwości klasy, które będą nam później pomocne:

private $conf_countryid = 	1; // id kraju (wymagane przez API)
private $conf_sysvar = 		1; // id systemu (wymagane przez API)
private $conf_login = 		'test_login'; // login konta Allegro
private $conf_password = 	'test_hasło'; // hasło konta Allegro
private $conf_apikey = 		'klucz_api'; // klucz WebAPI Allegro
private $conf_nresults_items = 	100; // ilość zwracanych aukcji użytkownika (podstawowe informacje)
private $conf_nresults_item_details = 	25; // ilość zwracanych szczegółowych informacji dotyczących aukcji użytkownika
private $tabsession = 		array(); // dane wykorzystywane w ramach sesji
private $id_session = 		''; // id sesji

Następnie musimy zaprojektować sobie klasę. W moim przypadku została ona skonstruowana w ten sposób, aby jeden obiekt pozwalał na tworzenie dowolnej ilości połączeń, zmieniając tylko dane logowania. Umożliwiają nam to metody connect() (połączenie z API), login() (logowanie do konta API), setProperty() (setter – ustawianie właściwości klasy – na przykład loginu i hasła), getProperty() (getter – pobieranie właściwości klasy):

public function connect(){
    try {
        $this->client = new SoapClient('http://webapi.allegro.pl/uploader.php?wsdl');
        $this->version = $this->client->doQuerySysStatus($this->conf_sysvar, $this->conf_countryid, $this->conf_apikey);
    } catch (SoapFault $soapFault){
        $aReturn['error_code'] = $soapFault->faultcode;
        $aReturn['error_msg'] = $soapFault->faultstring;
        return $aReturn;
    }
}

public function login(){
    if(!$this->id_session){
        try {
            $this->tabsession = $this->client->doLogin($this->conf_login, $this->conf_password, $this->conf_countryid, $this->conf_apikey,     $this->version['ver-key']);
            $this->id_session = $this->tabsession['session-handle-part'];
        } catch (SoapFault $soapFault) {
            $aReturn['error_code'] = $soapFault->faultcode;
            $aReturn['error_msg'] = $soapFault->faultstring;
            return $aReturn;
        }
    }
}

public function getProperty($sName){
    return $this->{$sName};
}

public function setProperty($sName, $sValue){
    $this->{$sName} = $sValue;
}

Jak widać ID sesji zwracane jest dopiero przy metodzie logowania. Jest ono nam potrzebne do większości metod Allegro API. Niektóre jednak go nie wymagają, więc nie potrzebujemy nawet loginu i hasła konta Allegro. Nijak nam to nie pomaga, ponieważ do uzyskania samego klucza są te dane potrzebne. Warto też zwrócić uwagę na metodę doQuerySysStatus() która zwraca nam numer komponentu który jest wykorzystywany. Nie rozumiem za bardzo dlaczego Allegro zdecydowało się aby numer ten był wymagany w niektórych metodach, zamiast przekazywać go w sesji. Musimy go więc pobrać aby później go przekazać w innej metodzie. Być może takie rozwiązanie jest przydatne, ale póki co nie dla mnie.
Metoda connect() jest zawarta w konstruktorze, aby ułatwić nieco zadanie. Żeby więc połączyć się z Allegro API, wystarczy nam coś takiego:

$oAllegro = new AllegroAPI();
$oAllegro->login();

Jeśli zaś usuniemy z konstruktora połączenie, mamy wtedy większą elastyczność w definiowaniu samego połączenia:

$oAllegro = new AllegroAPI();
$oAllegro->setProperty('conf_login', 'twoj_login');
$oAllegro->setProperty('conf_password', 'twoje_haslo');
$oAllegro->connect();
$oAllegro->login();

Skoro już jesteśmy połączeni z API, możemy pobrać aukcje użytkownika. Aby tego dokonać musimy wywołać metodę doGetUserItems(). Niestety przekazywane jest tam ID użytkownika a nie jego login. Aby pobrać ID na podstawie nazwy użytkownika Allegro, potrzebujemy metody doGetUserID(). Mając już listę aukcji danego użytkownika, możemy pobrać ich treści, które będą nam potrzebne do wyszukiwania odpowiedniego ciągu znaków. Metodą doGetItemsInfo() pobieramy wszystkie potrzebne informacje dotyczące danej aukcji (wraz z całą treścią aukcji wyświetlanej na Allegro). Cała metoda wyszukująca ciągu znaków w aukcjach wygląda następująco:

public function getUserAuctions($sUserLogin, $sSearch, $bCaseSensitive = false){

		$nFound = 0;
		$aReturn = array();
		$aUserItems = array();
		$idUser = 0;

		// zanim pobierzemy liste, musimy pobrac id uzytkownika na podstawie loginu
		try {
			$idUser = $this->client->doGetUserID($this->conf_countryid, $sUserLogin, '', $this->conf_apikey);
		} catch (SoapFault $soapFault){
			$aReturn['error_code'] = $soapFault->faultcode;
			$aReturn['error_msg'] = $soapFault->faultstring;
			return $aReturn;
		}

		if($idUser>0){

			$nOffset = 0;
			$aItemsIds = array();

			// nie mozemy pobrac od razy wszystkich przedmiotow, wiec pobieramy je paczkami
			// uzywajac offset i limit (ograniczenia allegro webapi)
			do {
				$aUserItems = array();
				$aUserItems = $this->client->doGetUserItems($idUser, $this->conf_apikey, $this->conf_countryid, $nOffset, $this->conf_nresults_items);

				for($i=0; $i{'it-id'};
				}

				$nOffset++;
			} while ($nOffset*$this->conf_nresults_items < $aUserItems['user-item-count']);

			// pobieramy szczegolowe informacje o przedmiotach
			// rowniez pakietami (max 25 na polaczenie)
			do {
				$aItemsGetDesc = array();

				for($j=0; $j<$this->conf_nresults_item_details; $j++){
					if(count($aItemsIds)>0){
						$aItemsGetDesc[] = array_shift($aItemsIds);
					}
				}

				$aItemDetails = array();
				$aItemDetails = $this->client->doGetItemsInfo($this->id_session, $aItemsGetDesc, 1 ,0, 0, 0, 0);

				for($k=0; $k{'item-info'}->{'it-description'}, $sSearch)!==false){
							$nFound++;
						}
					} else {
						if(strpos($aItemDetails['array-item-list-info'][$k]->{'item-info'}->{'it-description'}, $sSearch)!==false){
							$nFound++;
						}
					}

				}

			} while (count($aItemsIds)>0);

		}

		// zwracamy tablice z wynikami
		$aReturn['total_auctions_count'] = $aUserItems['user-item-count'];
		$aReturn['baner_auctions_count'] = $nFound;

		return $aReturn;

	}

Aby więc sprawdzić czy użytkownik posiada aukcje z określonym ciągiem znaków wywołujemy następujący fragment kodu:

$oAllegro = new AllegroAPI();
$oAllegro->login();
$tabUA = $oAllegro->getUserAuctions('uzytkownik_allegro', 'szukany_ciag_znakow');
var_dump($tabUA);

Nie wiem ilu osobom przyda się taka funkcjonalność, ale mam nadzieję że pozwoli ona przybliżyć nieco istotę oraz zasady działania WebAPI Allegro.

Całą klasę do obsługi można pobrać z tego miejsca: AllegroAPI

UWAGA:
W związku z tym, że Allegro WebAPI ciągle się zmienia a zmiany niestety nie zawsze są kompatybilne wstecz, przykładowy skrypt oraz klasa do obsługi WebAPI mogą nie działać. Tutorial zamieszczony jest w celu przybliżenia tematu wykorzystania WebAPI w aplikacjach pisanych w PHP. Jakiekolwiek zmiany w specyfikacji od daty umieszczenia tego wpisu nie będą więc uwzględniane.

Pozdrawiam.
robert@since78.pl