Entries
Labs.blogfrog.pl
Metoda entries umożliwia pobranie wpisów zagregowanych przez blogfroga z ostatnich dwóch miesięcy. Przy pobieraniu brane są pod uwagę kryteria, takie jak kategoria i minimalny frogrank wpisów.
Wywołanie metody odbywa sie poprzez interfejs REST. Wyślij żądanie HTTP GET na adres [apikey] z obowiązkowym parametrem "key" i 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 wpisów to: rss (zawiera tylko podstawowe dane), xml i json(zawierają rozszerzone dane). Dla wpisów domyślnym formatem jest rss.
Opcjonalne
- start
Ustaw ten atrybut > 0 aby otrzymać start+20 najnowszych wpisó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ę wpisów którą chcesz przeszukiwać
- minimal_rank
Podaj minimalny frogrank wpisów które 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='25'> <item> <blogs_title>TYTUL BLOGA</blogs_title> <blogs_id>ID BLOGA</blogs_id> <blogs_url>ADRES URL BLOGA</blogs_url> <link>LINK WPISU</link> <date>DATA PUBLIKACJI</date> <title>TYTUŁ</title> <description>KRÓTKI OPIS</description> <noterank>FROGRANK</noterank> <userrank>OCENA UŻYTKOWNIKÓW</userrank> <id>ID NOTKI</id> <themes_id>ID POPULARNEGO TEMATU</themes_id> <themes_priority>PRIORYTET W TEMACIE</themes_priority> </item> </result_object> </result> </blogfrog>
