Similar entries

Labs.blogfrog.pl

Metoda similar_entries umożliwia pobranie wpisów zagregowanych przez blogfroga podobnych do zadanego wpisu.

Wywołanie metody odbywa sie poprzez interfejs REST.  Wyślij żądanie HTTP GET na adres [api key]&url=[url]z obowiązkowym parametrem "key" oraz "url" i opcjonalnymi parametrami opisanymi poniżej.

Spis treści

Parametry


Obowiązkowe

  • key

Twój klucz API wygenerowany na stronie [1]

  • url /lub/ id

Blogfrogowy adres notki (np: http://blogfrog.pl/index.php/go/ODIzNzQz/I-ty- wybierz-trenera-polskich-siatkarzy) lub id notki (np: ODIzNzQz )

  • format

Wyjściowy format. Dostępne formaty dla wpisów to: rss (zawiera tylko podstawowe dane), xmljson(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ć.


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>