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.

Nasze pierwsze aplikacje gronowego API!

k3rni — Wed, 29 Aug 2007 16:53:00 +0200

Stworzyliśmy dwie aplikacje pod nowe Gronowe API, które opublikujemy tu już niedługo. Najbardziej interesujący w nich jest fakt, że pomimo naszego (gronowego działu R&D) poglądu na temat tego systemu operacyjnego, obie działają pod Windowsem.

Mają około 20 linijek kodu i napisane są w językach skryptowych. Wykonują użyteczne zadanie kosztem niewielkiej przestrzeni na dysku. Powstały jako przykłady do nowego API.

szybki uploader do avatarów: `avatar.cmd`


setlocal
set CURL="C:/Documents and Settings/kerni/Pulpit/curl-7.16.4/curl.exe" 
set COOKIEFILE=%TMP%/avacook.tmp
set LOGIN=__TU__MOJ_LOGIN__
set PASSWORD=__TU_MOJE_HASLO__
set LOGINARGS="login=%LOGIN%&password=%PASSWORD%&client=avatar_batch&cliver=1.0&lang=pl"^

%CURL% -v -c %COOKIEFILE% http://api.grono.net/pub/apilogin/ -d %LOGINARGS%
if not errorlevel 0 goto login_err

%CURL% -v -0 -b %COOKIEFILE% -Favatar=@%1 http://api.grono.net/api/avatar/%LOGIN%/
if not errorlevel 0 goto upload_err

goto end
:login_err
echo Bledne parametry logowania
goto end
:upload_err
echo Blad podczas uploadu
goto end

:end
endlocal

Wymaga CURLa, ale sprawuje się doskonale. Wykorzystuje technikę Drag&Drop do uploadowania plików na grono. Działa na każdym relatywnie świeżym windowsie, nie potrzebuje instalatora ani wpisów w rejestrze.

natywny blimp: `blimp.vbs`


' konfiguracja
LOGIN = "mojlogin" 
PASSWORD = "mojehaslo" 

' tworzymy xmlhttp
Set http = CreateObject("Microsoft.XmlHttp")
'logujemy sie na API
http.open "POST", "http://api.grono.net/pub/apilogin/", 0
' tak sie robi POST w MSXML
http.setRequestHeader "Content-Type", "application/x-www-form-urlencoded" 
http.send ("login=" + LOGIN + "&password=" + PASSWORD + "&client=avatar_vbs&cliver=0.1&lang=pl")

' sciagamy starego blimpa
http.open "GET", "http://api.grono.net/api/user/reklama/status/", 0
http.send
text = http.responseText

' zapytamy usera o nowego blimpa, podsuwajac mu stary
newtext = InputBox("Wpisz blimpa!", "BLIMP", text)

http.open "POST", "http://api.grono.net/api/user/reklama/status/", 0
http.setRequestHeader "Content-Type", "application/x-www-form-urlencoded" 
' send sie nam wywali bo POST zwroci HTTP 204 a nie 200
' czego MSXML juz nie kuma :)
On Error Resume Next
' wysylamy nowego blimpa
http.send ("status=" + newtext)

Brak wymagań i prostota użytkowania czynią go doskonałym przykładem. Dla wygody użytkownika pobiera starego blimpa i podsuwa go do zmodyfikowania. Wyglądem integruje się z resztą systemu operacyjnego.

dlaczego?

Stworzenie każdej z nich zajęło ok. 25 minut, z czego 20 na szukanie dokumentacji do XMLHTTP lub przypominanie sobie kontroli przepływu w plikach wsadowych. Celem było też odświeżenie umiejętności pisania w obskurnych językach i ćwiczenie cierpliwości w tworzeniu oprogramowania bez dedykowanych narzędzi.

linki

Oba programy znajdziecie tutaj. W przyszłości znajdzie się ich tam więcej. Istnieje też repozytorium, skąd można łatwo pobierać i przeglądać dostępne zasoby API. W planach jest umożliwienie dostępu do niego przez anonimowe svn.

Blimp API

admin — Tue, 05 Jun 2007 15:40:00 +0200

Udostępniamy Api do serwisu BLIMP. Jest ono dostępne pod adresem BLIMP API

Logowanie się

admin — Tue, 05 Jun 2007 15:29:00 +0200

Większość zasobów Grona jest dostępnych po zalogowaniu się. Te, które można używać bez autoryzacji, będą miały to oznaczone w opisie. Opis API Login

Ideologia REST w grono.net

admin — Tue, 05 Jun 2007 10:27:00 +0200

RestWiki opisuje REST jako "styl projektowania architektury oprogramowania prezentującego informacje w sieci WWW". Więcej na stronie GRONO REST

APIDoc: Category Blimp