API moBloga

MetaWebLog API

na podstawie API Blox.pl

Strona ta przeznaczona jest dla programistów chcących tworzyć aplikacje, które umożliwiają zarządzanie blogiem w serwisie moBlog.pl z pominięciem interfejsu www. Program taki może komunikować się z serwisem moBlog.pl bezpośrednio przy pomocy API.

Oferowane funkcjonalności:

• pobieranie listy blogów użytkownika
• pobieranie listy ostatnich notek z danego bloga
• tworzenie, edycja i kasowanie wpisów

Kompatybilność

API zostało stworzone w oparciu o technologię XML-RPC, a interfejs oparty jest na MetaWeblog API, co oznacza, że metody API moBlog.pl są z nim kompatybilne.

Żądania wywołania metod XML-RPC powinny być kierowane na adres URI: http://www.moBlog.pl/xmlrpc.

Metody obsługiwane przez API

blogger.getRecentPosts

Pobiera ostatnio napisane wpisy.

Parametry wywołania:

• appkey - ignorowany
• blogid - identyfikator liczbowy bloga pobrany metodą getUsersBlogs
• username - login właściciela moBloga
• password - hasło użytkownika
• numberOfPosts - liczba ostatnich wpisów, którą chcemy pobrać

Zwraca listę wpisów jako listę tablic z wartościami przypisanymi do kluczy:

• content - treść
• userid - login autora
• postid - identyfikator liczbowy wpisu
• dateCreated - data utworzenia wpisu

lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.

blogger.deletePost

Kasuje wpis.

Parametry wywołania:

• appkey - ignorowany
• postid - identyfikator liczbowy wpisu
• username - login właściciela moBloga
• password - hasło użytkownika
• publish - ignorowane

Zwraca true lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.

blogger.getUsersBlogs

Pobiera adresy moBlogów użytkownika.

Parametry wywołania:

• appkey - ignorowany
• username - login właściciela moBloga
• password - hasło użytkownika

Zwraca listę adresów jako listę tablic z wartościami przypisanymi do kluczy:

• blogid - identyfikator moBloga
• url - adres url moBloga
• blogName - nazwa moBloga

lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.

Obsługiwane metody z API MetaWebLog

metaWeblog.newPost

Dodaje nowy wpis.

Parametry wywołania:

• blogid - identyfikator liczbowy moBloga pobrany metodą getUsersBlogs
• username - login właściciela moBloga
• password - hasło użytkownika
• content - treść wpisu jako tablica z wartościami przypisanymi do kluczy:
  • flNotOnHomePage - ignorowany
  • title - tytuł wpisu(max 255 znaków)
  • description - treść (max 16KB)
  • categories - lista nazw tagów, które mają być przypisane do wpisu (maksymalnie 4), lub brak wartości - wtedy do wpisu nie zostaną przypisane żadne tagi
  • pubDate - ignorowany, zawsze ustawiana jest bieżąca data
  • guid - ignorowany
  • author - ignorowany, autorem jest zawsze właściciel moBloga
• publish - czy wpis ma być opublikowany (true) czy zapisany jako szkic (false)

Zwraca identyfikator nowo utworzonego wpisu lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.

metaWeblog.editPost

Modyfikuje wpis.

Parametry wywołania:

• postid - identyfikator wpisu
• username - login właściciela moBloga
• password - hasło użytkownika
• content - treść wpisu jako tablica z wartościami przypisanymi do kluczy:
  • flNotOnHomePage - ignorowany
  • title - tytuł wpisu (max 255 znaków)
  • description - treść (max 16KB)
  • categories - lista nazw tagów, które wpis będzie miał przypisane (maksymalnie 4), lub brak wartości - wtedy wpis nie będzie miał przypisanego żadnego tagu
  • pubDate - ignorowany, zawsze ustawiana jest bieżąca data
  • guid - ignorowany
  • author - ignorowany, autorem jest zawsze właściciel moBloga
• publish - czy wpis ma być opublikowany (true) czy zapisany jako szkic (false)

Zwraca true lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.

metaWeblog.getPost

Pobiera wpis.

Parametry wywołania:

• postid - identyfikator wpisu
• username - login właściciela moBloga
• password - hasło użytkownika

Zwraca tablicę z wartościami przypisanymi do kluczy:

• title - tytuł wpisu
• description - treść
• categories - lista nazw tagów, które ma przypisany wpis
• pubDate - data publikacji
• guid - identyfikator wpisu
• author - login autora

lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.

metaWeblog.getRecentPosts

Pobiera ostatnio opublikowane wpisy.

Parametry wywołania:

• blogid - identyfikator liczbowy moBloga pobrany metodą getUsersBlogs
• username - login właściciela moBloga
• password - hasło użytkownika
• numberOfPosts - liczba ostatnich wpisów, które chcemy pobrać

Zwraca listę notek jako listę tablic z wartościami przypisanymi do kluczy:

• title - tytuł wpisu
• description - treść
• categories - wektor nazw tagów, które posiada przypisany wpis, lub brak wartości
• pubDate - data publikacji
• guid - identyfikator wpisu
• author - login autora wpisu

lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.

metaWeblog.getCategories

Pobiera wszystkie kategorie (w moBlogu są to tagi).

Parametry wywołania:

• blogid - identyfikator liczbowy moBloga pobrany metodą getUsersBlogs
• username - login właściciela moBloga
• password - hasło użytkownika

Zwraca listę tagów jako listę tablic z wartościami przypisanymi do kluczy:

• htmlUrl - nazwa tagu
• description - nazwa tagu

lub błąd wywołania procedury zgodny ze specyfikacją XML-RPC.