vanessa bryant

donna summer dead

facebook stock

rondo

blipi

API – Interfejs programistyczny Blipi


Jak uzyskać dostęp do API?

Metody dotyczące trendów i statystyk dostępne są dla wszystkich. Aby mieć dostęp do naszego API wyszukiwania, wymagany jest klucz. Jeśli chcesz go otrzymać, wyślij email na adres info@blipi.pl z nazwą i krótkim opisem aplikacji, która będzie API używać. Możesz też kontaktować się za pomocą konta na Blipie – pisz do ^blipi


Jak komunikować się z API?

Dostępne są następujące metody, w miejsce słowa [apikey] należy wstawić swój klucz do API – posiadaczy klucza prosimy o podawanie go we wszystkich zapytaniach, zamiast słowa get:


Statystyki blipowicza. Poniższy przykład pokazuje jak otrzymać statystyki użytkownika f055:

api.blipi.pl/get/stats/f055
zwraca JSON:

  {"user":"/users/f055",
"trackedby":206,
"trackedbychange":"+1",
"tracking":362,
"trackingchange":0,
"citations":72,
"mentions":15,
"rank":80,
"rankchange":"+1"}

W przypadku użytkowników komercyjnych kont, wartość rank zawsze wynosi 0, a parametr rankchange się nie pojawia.


Ranking Top100. Poniższy przykład pokazuje jak otrzymać listę 10. lub 100. najpopularniejszych blipowiczów:

api.blipi.pl/get/top
api.blipi.pl/get/top100
zwraca JSON:

  [{"trackedby":"747","user":"/users/gadzinowski",rank:6},
{"trackedby":"871","user":"/users/mediafun",rank:3},
{"trackedby":"715","user":"/users/reuptake",rank:7},
{"trackedby":"595","user":"/users/hazan",rank:9},
{"trackedby":"1033","user":"/users/njet",rank:2},
...]


Popularne strony i tagi. Poniższy przykład pokazuje jak otrzymać listę najpopularniejszych stron i tagów w danej chwili, oraz popularne tagi z danego dnia:

api.blipi.pl/get/popular
zwraca JSON:

  {"tags":{
"now":["foto","iphone","slucham","muzyka","blipdnia","słucham","wyraz"],
"today":["magdusia","photoshop","moda","zima","fotografia","kino","firefox"]},
"links":{
"now":[
{"domain":"pleaserobme.com","url":"http://re.blipi.pl/5jdki","title":"Please Rob Me"},
{"domain":"maszignora.pl","url":"http://re.blipi.pl/5ckvv","title":"www.MaszIgnora.pl"},
{"domain":"i.imgur.com","url":"http://re.blipi.pl/5mu8c","title":"i.imgur.com"}
]}
}


Wyszukiwarka (wymaga klucza). Poniższy przykład pokazuje jak znaleźć 10 ostatnich blipnięć zawierających frazę blipi:

api.blipi.pl/[apikey]/search/blipi&offset=15
zwraca JSON:

  [{"user_avatar":"http://blip.pl/users/martiger/avatar/pico.jpg","blipid":"212867515",
"create_date":"2010-11-15 15:39:12","user":"/users/martiger",
"content":"Dostałem od ^blipi odznakę "Fandroid"! Zobacz ją na mojej stronie http://rdir.pl/ysbxx #blipibadge","rank":1},
{"user_avatar":"http://blip.pl/users/beao/avatar/pico.jpg","blipid":"212738069",
"create_date":"2010-11-15 13:45:04","user":"/users/beao",
"content":"Dostałam od ^blipi odznakę "Meloman"! Zobacz ją na mojej stronie http://rdir.pl/11d0to #blipibadge","rank":2},
{"user_avatar":"http://blip.pl/users/yurek55/avatar/pico.jpg","blipid":"212455149",
"create_date":"2010-11-15 07:54:27","user":"/users/yurek55",
"content":"Dostałem od ^blipi odznakę "Warszawiak"! Zobacz ją na mojej stronie http://rdir.pl/118r58 #blipibadge","rank":3},
...]

Znaki specjalne wykorzystywane przy wyszukiwaniu, które należy escapować przed umieszczeniem w zapytaniu do API to: # (podwójny escape, czyli %2523), / (podwójny escape, czyli %252F), @ (czyli %40) oraz ^ (czyli %5E).


Rozwinięcie dyskusji (wymaga klucza). Poniższy przykład pokazuje jak rozwinąć dyskusję blipnięcia o id 212256469:

blipi.pl/[apikey]/search/s%252F[blipid]
blipi.pl/[apikey]/search/s%252F212256469
zwraca JSON:

  [{"user_avatar":"http://blip.pl/users/mrsatan/avatar/pico.jpg","blipid":"212967095",
"create_date":"2010-11-15 17:11:59","user":"/users/mrsatan",
"content":"http://blip.pl/s/212936717 to trzeba na kogoś zrzucić, ^shinek pasuje ;P","discussion":{
"212936717":{
"user":"/users/afterdesign","content":"http://blip.pl/s/212910055 to musi być problem kogoś ;) Ot tak wisieć nie może ;)","create_date":"2010-11-15 16:44:35"},
"212814895":{
"user":"/users/ping","content":"http://blip.pl/s/212814127 ale w stopce Cie jeszcze nei ma :<< czekamy!","create_date":"2010-11-15 14:51:32"},
...}
}]

Blipnięcia w liście discussion nie zawsze są zwracane posortowane, ale chronologia może być odczytana z id blipnięcia. Lista discussion zawiera też oryginalne blipnięcie-źródło, w tym przypadku o id 212256469.


Ulubione (wymaga zatwierdzenia domeny jako referer). Poniższy przykład pokazuje jak dodać do ulubionych blipnięcie o id 212256469:

blipi.pl/bookmark/212256469
zwraca JSON:

  {"result":1,"blipid":212256469}  

Zmienna result ma wartość 1, jeśli blipnięcie zostało dodane. Ponowne wywołanie zapytania zwróci result z wartością -1, co oznacza, że blipnięcie zostało usunięte z ulubionych. Wartość 0 oznacza błąd.

Operacje na ulubionych opierają się na ataku XSRF. Użytkownik aplikacji korzystającej z tej metody musi być zalogowany do BLIPI, czyli posiadać ciasteczko autoryzacji. Jednocześnie HTTP Referer aplikacji musi być wpisany na white-listę BLIPI. Prosimy kontaktować się w tej sprawie na info@blipi.pl.