APIDoc: Category Konkursy

Podsumowanie konkursu

k3rni — Mon, 17 Dec 2007 16:09:00 +0100

Pierwsze zgłoszenie przyszło 24 listopada. Ostatnie 15 minut przed deadlinem.

W konkursie wzięły udział 22 osoby, nie było wśród nich żadnych kobiet. Aplikacji przesłanych na konkurs było za to 25, co oznacza że 3 osoby zgłosiły więcej niż jedną (a ściślej dwie).

Środowiska według popularności:

WWW – 9
Windows – 8
Cross-platform – 5
MacOS – 2
Linux – 1

Nie da się wskazać dominującego języka programowania. Używaliście bardzo różnych technologii, w tym Ruby on Rails, C#, Pythona, PHP. Sporo widgetów było napisane w HTML+CSS+Javascript, lecz to głównie ze względu na platformy które wybieraliście.

Od każdego ze zgłaszających wymagany był kod źródłowy. Posłużył nam on do “postawienia” niektórych aplikacji na naszych wewnętrznych serwerach, a w pozostałych do weryfikacji czy program nie robi nic podejrzanego. Niektóre ze zgłoszeń mają ustaloną licencję (głównie GPL), większość nie ma. Bez Waszej zgody nie będziemy w żaden sposób udostępniać kodu czy aplikacji – chcemy z Wami współpracować w tej kwestii. O tym zresztą dalej. Wszyscy też wywiązaliście się z wymagań zadeklarowania używanych komponentów i ich praw autorskich. Była to w zasadzie tylko kwestia znalezienia sobie darmowych komponentów, i wypisania nam w skrócie na jakich licencjach są.

Sędziowanie zostawione było na ostatnią chwilę – gdy wszyscy członkowie Kapituły wreszcie mogli zasiąść z kawą i na spokojnie ocenić wszystkie zgłoszenia. Każdy z programów miał swoje 5 minut, i pierwsze wrażenie liczyło się mocno, choć nie było decydujące.

Z wieloma widgetami czy aplikacjami mieliśmy problem – ciężko je było nam uruchomić. Główne przyczyny tego to zaszyte w kodzie na stałe URLe, wymagania nietypowych bibliotek czy też specyficznej wersji PHP. Widget pod Adobe AIR nie chciał działać w najnowszej (nadal beta) wersji środowiska, ruszył dopiero po zainstalowaniu starszej. Podobnie było z widgetem pod Yahoo, choć tam trzeba było za to zainstalować najnowszą.

Regulamin konkursu określał jakie są główne kryteria oceny:

a) Funkcjonalność i ergonomia projektu,
b) Stopień wykorzystania zasobów Portalu,
c) Przejrzystość i zawartość merytoryczna dokumentacji
Dodatkowym kryterium wpływającym na ocenę Prac Konkursowych będzie funkcjonalność Pracy Konkursowej wspomagająca integrację społeczności Grono.net.

Kapituła zasiadła więc w sali konferencyjnej, skonfiskowano i podłączono do rzutnika pierwszy z brzegu laptop z Visŧą (potrzebną do odpalenia jednego z widgetów). Zabraliśmy ze sobą też jednego MacBooka, który był potrzebny w podobnym celu. I po kolei, każde zgłoszenie z przygotowanej uprzednio listy:

sprawdzamy czy działa. jeśli nie, naprawiamy lub instalujemy co trzeba. sporo rzeczy nie chodziło od razu.
prezentowany jest opis aplikacji, według autora i według mnie, czyli rezultaty wcześniejszych uruchomień
Kapituła podziwia sam program, czyli wygląd jak i funkcjonalność, oraz rozważa oryginalność pomysłu
jeśli uzna go za godny dalszej uwagi, zapisujemy nazwisko autora na tablicy

Po przedstawieniu wszystkich zgłoszeń, Kapituła, nadal zamknięta w pokoju, oddawała głosy. Każda z 8 obecnych osób mogła przyznać po jednym punkcie trzem różnym zgłoszeniom. Z obserwacji wynikało, że bardzo istotne było pierwsze wrażenie, a najważniejsze – czytelność i funkcjonalność interfejsu. Każdy ważył jednak różne czynniki nieco inaczej – niektórzy stawiali na aspekt integracji społeczności, inni na bogactwo funkcji, jeszcze inni próbowali zweryfikować oryginalność pomysłu. Zaawansowanie techniczne nie było decydujące bezpośrednio, ale zdecydowanie łatwiej było wyróżnić się projektom ukończonym i dopracowanym. Jeśli program czy widget był napisany na szybko lub niedokończony, było to widać wyraźnie. Istotne też było, aby widget prezentował wyniki działania szybko – Kapituła nie miała czasu czekać 5 minut aż coś wyliczy czy zaktualizuje.

Po oddaniu głosów, nie było problemu z rozstrzygnięciem decyzji. Choć Kapituła była daleka od jednomyślności, nagrodzone projekty mocno odstawały od konkurencji, i jasne było komu przyznać nagrodę.

Z ostatniej chwili...

admin — Fri, 14 Dec 2007 21:00:00 +0100

Po kilku godzinach burzliwych narad, jury konkursu Widget Grono.net zdecydowało się ogłosić wyniki. Wszystkie zwycięskie prace zostaną opublikowane w poniedziałek 17 grudnia.

Zgodnie z regulaminem, laureaci miejsc 3, 4 i 5 otrzymują nagrody w postaci iPodów. Oto oni:

Miejsce piąte zajął Artur Nowak z Krakowa, twórca widgeta o nazwie „Gronostaj”.

Zdobywcą miejsca czwartego jest Grzegorz Furga z Warszawy, który stworzył aplikację „Kochalubiszanuje.net”.

Miejsce trzecie zajął Konrad Banaszek z Warszawy, autor „BLIMPera”.

Laureatem drugiego miejsca i zdobywcą komputera Apple MacBook jest Wojciech Polak z Łodzi, który stworzył „Grono.net Widget dla iGoogle”.

Zwycięzcą konkursu, otrzymującym nagrodę główną – komputer Apple MacBook Pro, jest Wiktor Gworek z Warszawy, autor projektu „Pięciosłówek”.

Wszystkim uczestnikom konkursu serdecznie dziękujemy.

Zostało Wam...

k3rni — Fri, 30 Nov 2007 12:16:00 +0100

Mniej niż 12 godzin na zgłaszanie aplikacji konkursowych. Zakończenie zbierania prac nastąpi dziś o północy, czyli kiedy piątek przejdzie w sobotę. Jak to kiedyś mówili w radiu, decyduje data stempla pocztowego, czyli kiedy przyjdzie email. Aby nie było problemów z precyzyjną definicją tej daty, sprawdźcie czy macie włączoną synchronizację czasu z sieci.

Dotychczasowe zgłoszenia są bardzo interesujące, i zapowiada się trudny wybór.

UPDATE: Jeśli nie otrzymacie dziś potwierdzenia, co może się zdarzyć szczególnie jeśli wyślecie widgeta bardzo późno, poczekajcie do jutra. Wtedy zbierzemy ostatecznie wszystkie zgłoszenia i wyślemy potwierdzenia.

Zgłaszanie prac konkursowych

k3rni — Fri, 23 Nov 2007 21:08:00 +0100

Koniec konkursu zbliża się wielkimi krokami, chcemy więc przypomnieć jak należy prawidłowo zgłaszać swoje prace.

Regulamin w punkcie 12 określa:

[...] W celu zgłoszenia udziału w Konkursie Uczestnik przesyła Pracę Konkursową na adres e-mail podany przez organizatora wraz z podaniem następujących danych: nazwa projektu, imię, nazwisko, pseudonim, wiek Uczestnika/członków zespołu oraz danych kontaktowych w postaci adresu email, adresu do korespondencji pocztowej oraz numeru telefonu.

W przypadku gdy Uczestnikiem konkursu jest zespół, Uczestnik przesyła Pracę Konkursową na adres e–mail podany przez organizatora wraz z podaniem następujących danych: nazwa projektu, imię, nazwisko, pseudonim, wiek osoby reprezentującej Uczestnika/członków zespołu we wszystkich czynnościach cywilnych i prawnych bezpośrednio i pośrednio związanych z Konkursem, w tym z odbiorem nagród przyznanych za zgłoszoną przez Uczestnika Pracę Konkursową.

Zgłoszenie do Konkursu następuje w chwili otrzymania przez Uczestnika potwierdzenia przesłanego przez Organizatora z konkursowego adresu Grono.net. Jeden Uczestnik może zgłosić nie więcej niż trzy Prace Konkursowe. Zgłoszenia do udziału w konkursie przyjmowane są do dnia 30 listopada 2007 r. [...]

Istotne są też ustalenia kolejnych punktów, szczególnie o prawach autorskich:

W przypadku gdy w Pracy Konkursowej uczestnik wykorzystał elementy stanowiące przedmiot praw na dobrach niematerialnych lub innych praw osób trzecich warunkiem uczestnictwa w Konkursie jest dołączenie do zgłoszenia dowodu uprawnień Uczestnika do wykorzystania korzystania z tego elementu w ramach Pracy Konkursowej.

Oznacza to, że jeżeli korzystacie np. z cudzych grafik czy kodu nie będącego na otwartej licencji, do pracy powinno być dołączone oświadczenie właściciela praw autorskich tychże grafik lub kodu. Zastrzegamy sobie prawo do wymagania tego oświadczenia w formie papierowej – więc bądźcie przygotowani. Punkt 14 i 15 regulaminu pozwala nam odrzucić pracę, a nawet cofnąć przyznanie nagrody, jeśli sytuacja prawna pracy konkursowej będzie niepewna.

Kolejna porcja poprawek

k3rni — Tue, 13 Nov 2007 15:53:00 +0100

Wprowadziliśmy dziś długo oczekiwane aktualizacje. Oto lista zmian, szczegóły jak zwykle w dokumentacji.

pobieranie nowego tokena zwraca parę (token, handle)
pobranie tokena gdy jest się zalogowanym na Gronie lub API w sposób zwykły (poprzez ciasteczka) zwróci kod 400 – gdyż nie jest to prawidłowa operacja
solidnie zwiększony limit wysyłania blimpów przez API (uwaga – może zostać skorygowany)
zwiększony limit wysyłania wiadomości gronowych poprzez API
przy pobieraniu profilu, można teraz ograniczyć listę pobieranych danych, co spowoduje zmianę w realizacji limitu. pokrótce, jeśli pobieramy 6 pól zamiast wszystkich 18, możemy wysłać 450 a nie 150 zapytań dziennie.
pole surname zawiera teraz nazwisko, a nie nazwę ekranową. mieliśmy literówkę w kodzie.

Platformy komórkowe - już można!

k3rni — Mon, 12 Nov 2007 17:01:00 +0100

Wprowadziliśmy zmianę w regulaminie konkursu. Teraz przyjmujemy jako zgłoszenia również widgety napisane jako aplikacje na platformy przenośne. Nie na wszystkie – macie 3 wybory:

Java Platform, Mobile Edition (J2ME), MIDP2.0
Symbian: S60 (nowe telefony Nokii)
Symbian: UIQ (Sony Ericsson, Motorola, BenQ, niektóre modele Nokii)

Ograniczenie do najpopularniejszych platform służy głównie dalszej popularności widgetu (ile osób ma iPhone?), oraz ułatwieniu nam testowania.

Wyciągnijcie zatem programy z szuflady, dopracujcie i zgłaszajcie!

Tam gdzie nie można użyć POST...

k3rni — Fri, 26 Oct 2007 11:51:00 +0200

...teraz można użyć GET. W parametrach zapytania musi znaleźć się POST=1. Wszystkie pozostałe parametry podajemy również w GET.

W ten sposób można wykonywać wiele operacji, z wyjątkami:

wykluczone z definicji są wszelkie uploady plików
nie można wykorzystywać innych formatów danych wejściowych – parametr in_format traci znaczenie
nie będzie również działać edycja bardziej złożonych struktur, np. geolokacji w profilu (która i tak nie działała bez podania danych w formacie innym niż HTTP). Jest to rzecz do naprawienia w następnym kroku – co nastąpi szybciej jeśli okaże się Wam rzeczywiście potrzebne.

Zastrzegamy sobie na przyszłość prawo selektywnego wyłączania obsługi operacji przez GET na dowolnych zasobach. Zawsze jednak uprzedzimy, i będziemy otwarci na argumenty.

Nowa metoda autoryzacji

k3rni — Thu, 25 Oct 2007 17:54:00 +0200

Nie wszystkie środowiska w których piszecie widgety konkursowe spełniają wymagania API: obsługę POST i ciasteczek. Przykładem niech będą widgety pisane pod iGoogle. Problem dostrzegliśmy jakiś czas temu, i dziś wprowadzamy jego rozwiązanie.

Login poprzez post na api.grono.net/pub/apilogin/ nie jest już jedyną dostępną metodą autoryzacji. Kolejną (być może nie ostatnią) jest korzystanie z tokena, więcej w dokumentacji.

Tymczasem w skrócie: wykonujecie GET lub POST na adres pobierania tokena, otrzymujecie krótko ważny token na żądany zasób. W kolejnych zapytaniach dołączacie token jako parametr w GET lub POST (zależnie od typu requesta) zamiast ciasteczek sesji. I tyle!

Niestety, bezpieczeństwo takiego rodzaju autoryzacji jest kiepskie, ponieważ hasło wysyłamy plaintextem, a ukradziony token to wszystko, czego potrzeba by dostać dostęp do zasobów Grona. Usprawiedliwić można to tylko tym, że standardowy sposób logowania oferuje równie niski poziom zabezpieczenia.

W przyszłości zamierzamy wprowadzić, również opartą na tokenach, bezpieczniejszą metodę autoryzacji, zbliżoną do Google AuthSub czy Flickr Auth API. Jak zwykle obserwujcie to miejsce, i zaprojektujcie swoje programy tak, aby łatwo było można wymienić moduł autoryzacji.

Jeśli nie masz profilu na Gronie…

k3rni — Wed, 24 Oct 2007 12:12:00 +0200

Jeśli chcecie wziąć udział w konkursie, a nie posiadacie konta na Gronie, pomożemy Wam zdobyć zaproszenie. Wyślijcie z formularza wiadomość do supportu, wybierając odpowiednią kategorię.

Wiadomość musi jednoznacznie stwierdzać, że chcecie wziąć udział w konkursie Widget Grono.net, ale nie macie konta, oraz zawierać e-mail na który chcecie otrzymać zaproszenie. Załoga Grono.net szybko zajmie się Waszym zgłoszeniem.

Logo Grona do wykorzystania

k3rni — Mon, 22 Oct 2007 14:50:00 +0200

Zewsząd padały sugestie, aby Grono udostępniło swój logotyp na potrzeby widgetów konkursowych. Dziś spełniamy tą prośbę – dajemy wam grafiki do wykorzystania.

Pod tym adresem znajdziecie oficjalne logo Grona w kilku formatach, głównie wektorowych ale jest i PNG. Uwaga: jeśli ktoś zechce zrobić wersję SVG, lub w jeszcze innych formatach. udostępnimy je wszystkim z tego samego miejsca. Na pewno przydałby się zestaw Windowsowych ikonek w różnych rozmiarach.

Do wykorzystania jest tylko forma graficzna – bez napisu “grono.net”, który jest zastrzeżony. Wasze programy/widgety nie mogą więc mieć w nazwie adresu Grona, a jedynie nawiązywać, lub w inny sposób sugerować że wykorzystują zasoby serwisu.

Miejcie też na uwadze, że logo udostępniane jest tylko i wyłącznie na potrzeby konkursu Widget Grono.net. Używanie go w innych celach może być naruszeniem praw autorskich. Dozwolone jest wykorzystanie loga Grona w złożonych kompozycjach, czyli np. możecie dodać ikonkę koperty do grona jeśli tworzycie widget do wysyłania wiadomości.