Blogs
Labs.blogfrog.pl
Metoda blogs umożliwia przeglądanie bazy wszystkich blogów zagregowanych przez blogfroga.
Wywołanie metody odbywa sie poprzez interfejs REST. Wyślij żądanie HTTP GET na adres 'http://blogfrog.pl/index.php/api/blogs?key=[apikey] z obowiązkowym parametrem "key" oraz opcjonalnymi parametrami opisanymi poniżej.
Spis treści |
Parametry
Obowiązkowe
- key
Twój klucz API wygenerowany na stronie [1]
- format
Wyjściowy format. Dostępne formaty dla blogów to: xml i json. Dla blogów domyślnym formatem jest xml
Opcjonalne
- start
Ustaw ten atrybut > 0 aby otrzymać start+20 blogów, np. ustaw start na 20+1 a otrzymasz drugą stronę wyników (wyniki 21-40)
- limit
Ustaw ten atrybut na wartość > 0 i mniejszą od 300 aby określić ile rekordów chcesz otrzymać.
- category
Podaj liczbę od 1 do 11 (Biznes, Internet, Kultura, Reklama, Media, Polityka, Rozrywka, Sport, Osobiste, Fotoblogi, Dla doroslych) określającą kategorię blogów którą chcesz przeszukiwać
- sort_by
Pole po którym sortować wyniki - "date" (sortowanie po dacie dodania bloga do serwisu malejąco), "note" (sortowanie po frogranku bloga malejąco).
Zwracane wartości
Metoda zwraca błąd HTTP 404 wraz z opisem gdy coś nie tak, w przeciwnym razie zwraca wynik w określonym formacie.
Formaty JSON i XML są bardzo podobne, mają następującą strukturę:
<?xml version="1.0" encoding="UTF-8"?> <blogfrog> <result> <result_id></result_id> <result_array type='array' size='0'></result_array> <result_object type='array' size='2'> <item> <tags>TAGI PRZYPISANE DO BLOGA</tags> <url>URL BLOGA</url> <title>TYTUŁ BLOGA</title> <feed_url>ADRES RSS</feed_url> <blog_note>FROGRANK</blog_note> <last_entry>DATA OSTATNIEGO WPISU</last_entry> <date_added>DATA DODANIA BLOGA DO SERWISU</date_added> <id>ID BLOGA</id> <description>OPIS BLOGA</description> <categories_id>ID KATEGORII</categories_id> <blog_rank_reference>OCENA REDAKCJI</blog_rank_reference> <position>POZYCJA NA LIŚCIE TOP</position> </item> </result_object> <current_row>0</current_row> <num_rows>ILOSC ZWROCONYCH WIERSZY</num_rows> </result> <time>CZAS WYKONANIA</time> <count>CALKOWITA ILOSC ZNALEZIONYCH REKORDOW</count> <query>ZAPYTANIE</query> </blogfrog>
