Co łączy trzy wymienione w tytule produkty? To że ich właściciele ogarnięci chęcią zysku (i nie tylko), zapomnieli do czego ich twór miał początkowo służyć. Zapewne nie są to jedyne przypadki ciągnięcia świetnie zapowiadającego się oprogramowania na dno, nie mniej chyba najbardziej znane.

Z pewnością wielu czytelników nie zgodzi się ze mną, wychwalając nadal używany produkt. Nie mniej, czy rozbudowanie doskonałego oprogramowania do wypalania krążków CD we wszystko mający kombajn multimedialny można nazwać dobrą ścieżką rozwoju? Czy upychanie reklam nawet do emotikonów jest pokierowane troską o użytkowników? I w końcu przekształcenie serwisu społecznościowego o szerokim gronie odbiorców w podrzędny portal randkowy dla nastolatków.

Gdzie się podziała stara, ale dobra zasada, mówiąca o tym że dobry programista nie zastanawia się co dodać do swojego programu, ale co odjąć!

Przerost formy nad treścią towarzyszy nam każdego dnia. W oprogramowaniu komputerowym znane jest sporo przykładów gdzie nadgorliwość producenta, czy też ogromna presja pieniądza potrafiły ściągnąć na dno najlepszą nawet aplikację.

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.