User blogs
Labs.blogfrog.pl
Metoda user_
blogs umożliwia przeglądanie blogów których właścicielem jest dany użytkownik. Wywołanie metody odbywa sie poprzez interfejs REST. Wyślij żądanie HTTP GET na adres http://blogfrog.pl/index.php/api/blogs?key=[apikey]&user_name=[user_name] z obowiązkowym parametrem "key" i "user_name" oraz opcjonalnymi parametrami opisanymi poniżej.
Spis treści |
Parametry
Obowiązkowe
- key
Twój klucz API wygenerowany na stronie [1]
- user_name
Nazwa użytkownika blogfroga, którego blogi chcemy przeglądać.
- 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ć.
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>
