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
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.