APIDoc

Aktualizacje API galerii

k3rni — Fri, 07 Mar 2008 14:59:00 +0100

Dla celów wewnętrznie tworzonej aplikacji (która zapewne zobaczycie już niedługo) potrzebowaliśmy nieco wzbogacić funkcjonalność dostępu do fotek i galerii.

I tak, lista zmian obejmuje co nastepuje:

w listingu galerii pojawiła się dodatkowo informacja o ilości fotek.
przy pobieraniu galerii można dodać opcję full=1. Spowoduje to zmianę formatu pola photos na nieco bogatszy, będący w zasadzie listą obiektów typu Photo które dotychczas musieliście pobierać osobno serią requestów.

Pozostałe operacje na fotkach pozostają niezmienione. Pojawi się jednak w przyszłości operacja przenoszenia fotek pomiędzy galeriami, oraz, być może, kilka innych oczekiwanych i/lub wymarzonych funkcji.

Szczegóły w dokumentacji. Miłego kodowania!

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.

Obserwowane wątki

k3rni — Wed, 21 Nov 2007 10:25:00 +0100

Zgłosiliście potrzebę dostępu do listy wątków obserwowanych przez użytkownika. W ramach dobrej współpracy, oto i one.

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!

Nowości i poprawki

k3rni — Mon, 05 Nov 2007 13:27:00 +0100

Dodaliśmy (wejdą z dzisiejszym deployem) kolejne funkcjonalności i poprawki w API:

W liście znajomych i grupach doszło pole online. Faktycznie było tam już wcześniej, ale dopiero teraz jest oficjalne.
Równiez w znajomych, jeśli użytkownik nie miał scrname (nazwy ekranowej), pole to pozostawało puste. Teraz zawierać będzie jego imię i nazwisko, jeśli ma wpisane.
Można odczytać listę gron tematycznych do których zapisany jest użytkownik. Szczegóły w dokumentacji.
Dostęp do cudzych grup znajomych został zablokowany.
Powtórne zalogowanie się na API zwróci użyteczną odpowiedź, zamiast kodu HTML strony głównej Grona.

Wylogowanie z API

k3rni — Mon, 05 Nov 2007 13:20:00 +0100

Jeśli korzystacie z ciasteczek sesji, zamiast tokenów, wiecie że nie było opcji wylogowania się. Od teraz jest – zapraszam do czytania (krótkiej) dokumentacji.