14th fev 2009
Classe para acessar a API do BlogBlogs
Fazendo alguns testes para a JS Calls PHP (biblioteca para integrar javascript e PHP), criei uma classe em PHP de acesso à API do BlogBlogs (o maior agregador de blogs tupiniquim).
A API disponibiliza consultas aos dados de usuários e seus blogs a partir do username dele no sistema, e busca informações de blogs pela url.
Para utilizar a classe, só é necessário fazer download da mesma e ter uma chave pública à API do BlogBlogs (totalmente gratuita).
Uma vez com a chave disponível, você poderá utilizar a classe da seguinte forma no seu script PHP:
//instancie o objeto e torque o XXXX… pela chave gerada
$minha_chave = “XXXXXXXXXXXXXXX”;
$bbService = new BlogBlogsService($minha_chave);
Para buscar por um usuário:
$bbService->setUserName($username);
Com isso, a classe fará a busca e você terá um objeto que representa o usuário do BlogBlogs que pode ser acessado assim:
$bbService->user;
Para acessar um atributo de um usuário:
$bbService->user->nome_do_atributo;
//Por exemplo: $bbService->user->fullName
Os atributoes desse objeto são:
- userName (login)
- firstName (primeiro nome)
- lastName (sobrenome)
- fullName (nome completo)
- thumbnailPicutre (url do avatar)
- profilePage (url da página do perfil do usuário)
- blogsCount (quantidade de blogs associados ao usuário)
- favoritesCount (quantidade de favoritos do usuário
- fansCount (quantidade de fans do usuário)
Esse objeto ainda possue uma lista de blogs. A lista de blogs pode ser acessada pela sintaxe:
$bbService->user->blogs
Cada blog possue os seguintes atributos:
- name (nome do blog)
- url (url)
- rssUrl (url do RSS)
- blogPage (url do blog no BlogBlogs)
- lastUpdate (data da última atualização)
- inboundBlogs (quantidade de blogs que linkam o blog)
- inboundLinks (quantifade de links para o blog)
- rank (ranking do blog no BlogBlogs)
- lang (língua do blog)
Exemplo de como percorrer a lista de blogs do usuário e exibir a url dele:
foreach($bbService->user->blogs as $blog) {
$blog->url . “<br />”;
}
Existe ainda a chance de fazer a busca por um blog no BlogBlogs pela url dele. Pode ser usado o método getBlogByUrl(url) que retorna um objeto do tipo blog (explicado àcima). Como fazer?
$bbService->getBlogByUrl(“http://www.chrisb.com.br/blog/”)
//para exibir o nome do blog
$bbService->getBlogByUrl(“http://www.chrisb.com.br/blog/”)->name;
Sugiro que dêem uma olhada na documentação oficial da API. E espero que essa classe ajude!
Posts relacionados
Avalie
(No Ratings Yet)
Leave a Reply