@master
Blog (23)
Komentarze (1.2k)
Recenzje (0)

Allegro WebAPI – koszmar programisty

@masterAllegro WebAPI – koszmar programisty24.02.2010 17:30

Podczas tworzenia kilku z moich niedawnych projektów, wykorzystujących Allegro WebAPI, mogę śmiało powiedzieć że jest to najgorsze API jakie przyszło mi wykorzystywać.

Co to jest WebAPI? Jest to system pozwalający, przy pomocy protokołu SOAP, na integrację naszej aplikacji z serwisem Allegro. Może wyszukiwać aukcje, wystawiać nowe, sprawdzać stan konta oraz dziesiątki innych rzeczy które wykonuje użytkownik tego serwisu.

W czym więc problem? Zapraszam do dalszej części wpisu wyjaśniającej dlaczego każde zetknięcie z tym tworem Allegro kończy się białą gorączką.

Zacznijmy od skandalicznej dokumentacji. Funkcje opisane są bardzo skąpo, na przemian w języku polskim oraz angielskim (w obrębie jednego opisu), w większości brak przykładów oraz objaśnień zwracanych wartości. Na potwierdzenie tej tezy może przemawiać fakt iż pewien czas temu serwis Allegro zorganizował konkurs na (uwaga) napisanie dokumentacji do WebAPI. Przepraszam bardzo, ale jakim cudem, nawet najbardziej uzdolniony programista ma wiedzieć jak działa czyiś twór (bez dostępu do źródeł) i jeszcze to udokumentować? Akcja ta została zbojkotowana przez liczne grono użytkowników API.

Idąc dalej, możliwości funkcji jakie zostały oddane nam do użytku są lata za możliwościami serwisu Allegro. Innymi słowy, serwis jest stale rozwijany ale WebAPI do jego obsługi już niekoniecznie. Porównując możliwości wyszukiwarki Allegro, do dostarczonej funkcji doSearch możemy odnieść wrażenie że korzystamy z Allegro lat 90-tych.

Jeśli już przebrniemy przez kiepską dokumentację oraz zaimplementujemy potrzebne nam funkcje, przychodzi czas testów. Allegro oddaje nam do tego celu specjalną wersję swojego serwisu http://testwebapi.pl. W serwisie tym, najprościej mówiąc, możemy być niegrzecznymi chłopcami – wystawiać aukcje oraz robić co nam się podoba, po prostu testować nasze oprogramowanie. I wszystko było by w porządku, gdyby nie fakt, iż ten serwis również pozbawiony jest szeregu funkcjonalności. Przykładowo, lista kategorii jest całkowicie inna niż ta z oficjalnej strony, co uniemożliwia testowanie chociażby pól specjalnych niektórych z nich.

Wykorzystywałem Allegro WebAPI już kilka razy w swoich projektach i za każdym razem wygląda to podobnie, frustracja i szukanie w internecie jak dokładnie działa konkretna funkcja (na stronach ludzi którzy poświęcili pół życia aby ją zrozumieć).

© dobreprogramy·Redakcja·Regulamin·Polityka prywatności·Reklama·Kontakt
Szanowna Użytkowniczko! Szanowny Użytkowniku!
×
Aby dalej móc dostarczać coraz lepsze materiały redakcyjne i udostępniać coraz lepsze usługi, potrzebujemy zgody na dopasowanie treści marketingowych do Twojego zachowania. Twoje dane są u nas bezpieczne, a zgodę możesz wycofać w każdej chwili na podstronie polityka prywatności.

Kliknij "PRZECHODZĘ DO SERWISU" lub na symbol "X" w górnym rogu tej planszy, jeżeli zgadzasz się na przetwarzanie przez Wirtualną Polskę i naszych Zaufanych Partnerów Twoich danych osobowych, zbieranych w ramach korzystania przez Ciebie z usług, portali i serwisów internetowych Wirtualnej Polski (w tym danych zapisywanych w plikach cookies) w celach marketingowych realizowanych na zlecenie naszych Zaufanych Partnerów. Jeśli nie zgadzasz się na przetwarzanie Twoich danych osobowych skorzystaj z ustawień w polityce prywatności. Zgoda jest dobrowolna i możesz ją w dowolnym momencie wycofać zmieniając ustawienia w polityce prywatności (w której znajdziesz odpowiedzi na wszystkie pytania związane z przetwarzaniem Twoich danych osobowych).

Od 25 maja 2018 roku obowiązuje Rozporządzenie Parlamentu Europejskiego i Rady (UE) 2016/679 (określane jako "RODO"). W związku z tym chcielibyśmy poinformować o przetwarzaniu Twoich danych oraz zasadach, na jakich odbywa się to po dniu 25 maja 2018 roku.

Kto będzie administratorem Twoich danych?

Administratorami Twoich danych będzie Wirtualna Polska Media Spółka Akcyjna z siedzibą w Warszawie, oraz pozostałe spółki z grupy Wirtualna Polska, jak również nasi Zaufani Partnerzy, z którymi stale współpracujemy. Szczegółowe informacje dotyczące administratorów znajdują się w polityce prywatności.

O jakich danych mówimy?

Chodzi o dane osobowe, które są zbierane w ramach korzystania przez Ciebie z naszych usług, portali i serwisów internetowych udostępnianych przez Wirtualną Polskę, w tym zapisywanych w plikach cookies, które są instalowane na naszych stronach przez Wirtualną Polskę oraz naszych Zaufanych Partnerów.

Dlaczego chcemy przetwarzać Twoje dane?

Przetwarzamy je dostarczać coraz lepsze materiały redakcyjne, dopasować ich tematykę do Twoich zainteresowań, tworzyć portale i serwisy internetowe, z których będziesz korzystać z przyjemnością, zapewniać większe bezpieczeństwo usług, udoskonalać nasze usługi i maksymalnie dopasować je do Twoich zainteresowań, pokazywać reklamy dopasowane do Twoich potrzeb. Szczegółowe informacje dotyczące celów przetwarzania Twoich danych znajdują się w polityce prywatności.

Komu możemy przekazać dane?

Twoje dane możemy przekazywać podmiotom przetwarzającym je na nasze zlecenie oraz podmiotom uprawnionym do uzyskania danych na podstawie obowiązującego prawa – oczywiście tylko, gdy wystąpią z żądaniem w oparciu o stosowną podstawę prawną.

Jakie masz prawa w stosunku do Twoich danych?

Masz prawo żądania dostępu, sprostowania, usunięcia lub ograniczenia przetwarzania danych. Możesz wycofać zgodę na przetwarzanie, zgłosić sprzeciw oraz skorzystać z innych praw wymienionych szczegółowo w polityce prywatności.

Jakie są podstawy prawne przetwarzania Twoich danych?

Podstawą prawną przetwarzania Twoich danych w celu świadczenia usług jest niezbędność do wykonania umów o ich świadczenie (tymi umowami są zazwyczaj regulaminy). Podstawą prawną przetwarzania danych w celu pomiarów statystycznych i marketingu własnego administratorów jest tzw. uzasadniony interes administratora. Przetwarzanie Twoich danych w celach marketingowych realizowanych przez Wirtualną Polskę na zlecenie Zaufanych Partnerów i bezpośrednio przez Zaufanych Partnerów będzie odbywać się na podstawie Twojej dobrowolnej zgody.