Current File : /home/users/barii/public_html/finansenl.com.pl/wodki/api/demo/README.md

PHP-Allegro-rest-api dla opornych, czyli małe rest-api-howto.

A. Proces rejestracji aplikacji w allegro

1. Logujesz sie do serwisu na swoje konto.
2. na https://apps.developer.allegro.pl/ rejestrujesz swoją aplikację
   a) Możesz podać dowolną nazwę aplikacji np twoj_login-api . Tej nazwy już nie zmienisz
      lecz nie ma to żadnego znaczenia dla aplikacji poza tym, że pojawia się w pytaniu
      do użytkownika, czy zezwala tej aplikacji na dostęp do jego danych.
   b) W polu Adresy przekierowań ja wpisałem nazwę mojego serwera - domenę,
      która na niego wskazuje np. http://twoj_server.com lub https://twoj_server.com
      Później w aplikacji można wskazać konkretny plik.php w którym jest aplikacja.
      Te dane można edytować w Allegro.
   c) Ja miałem już identyfikator SOAP WEB API ( Api KEY ) i pojawił się poniżej. 
      Też jest potrzebny.
   d) Zrób copy + paste do pliku textowego wszystkich kluczy na stronie po zakończeni
      tej rejestracji.

B. Uruchomienie demo na Twoim serwerze.


INFORMACJA: całe demo jest oparte o napisany przez Wiatrogon'a php-allegro-rest-api 
dostępne tu: https://github.com/Wiatrogon/php-allegro-rest-api
Ja tylko troszkę poprawiłem procedurę get() i utworzyłem ApiTest.php w oparciu
o fragmenty tamtego pliku README.
Licencja wynika z licencji na php-allegro-rest-api


1. Demo używa PHP5. Ja używałem v 5.6. Jeśli coś Ci nie działa, to znaczy,
   że brakuje jakichś modułów w PHP. Proponuję phpinfo() i dodanie modułów
   PHP.
2. Pliki *.php przekopiuj do katalogu /api/demo/ na swoim serwerze. Nie piszę
   o takich drobiazgach, jak odpowiednie prawa (R/W/X) do plików i katalogu oraz
   o tym, że to Twój serwer www powinien widzieć katalog, jako /api/demo/
   Jeśli przeniesiesz demo do innego katalogu - zmień 12 linię pliku ApiTest.php
   Poniżej ( w 13-17 linii tego pliku znajduje się stosowny opis )
3. Plik api_login.php przeedytuj - wpisując tam dane pobrane z allegro ( punkt A.2.d ).
4. Za pomocą przeglądarki wybierz adres: ( https:// lub ) http://your_server.com/api/demo/ApiTest.php
   ( gdzie oczywiście your_server.com to adres Twojego servera ).
   Allegro nie dopuszcza w nazwie serwera adresu IP.

C. Po kilkunastu sekundach powinno pojawić się w przeglądarce dużo textu.
   Jeśli tak nie jest - trzeba jednorazowo uruchomić autentykację ręcznie i będąc 
   zalogowanym do allegro.pl [ zwykłe konto użytkownika ] wyrazić zgodę na dostęp
   aplikacji o nazwie, jaką zarejestrowałeś ( punkt A.2.a ) do Twojego konta.
   W tym celu trzeba odkomentować linię nr 25. Jest tam stosowna instrukcja.
   Po wyrażeniu zgody można tą linię zakomentować spowrotem.

D. W definicji klasy Resource pod koniec zakomentowane są 4 linie tworzące log z zapytań
   wysyłanych do allegro. Mnie to bardzo pomogło w konstrukcji wielu z nich. Jeśli to 
   odkomentujesz - w /tmp/ utworzy się log z tymi zapytaniami.

E. Plik ApiTest.php jest okomentowany przeze mnie w stopniu dość dużym. Zawiera on
   gotowe odpowiedzi na pytanie, jak dotrzeć do listy aukcji i jak wyodrębnić określone
   pola odpowiedzi z serwera Allegro. Na końcu powturzone są też elementy z howto 
   Wiatrogon'a Ja używałem tylko metody GET. Nie mam innych potrzeb na razie. PUT i DELETE
   pozostawiam do przećwiczenia innym.

Have Fun
GrzegorzJJ