Socialid.selfie.posts

Description

Realiza a busca de posts moderados para uma determinada hashtag.

Usage

 socialid.selfie.posts(hashtag, handler, options)

Parameters

hashtag	obrigatório	Hashtag dos posts a serem retornados.
handler	opcional	Especifica uma função de callback para tratar a resposta da API.
options	opcional	um objeto contendo parâmetros adicionais
page	opcional	Número da página dos resultados. Default: 1.
limit	opcional	Número máximo de resultados para serem retornados na página. Default: 15.
order	opcional	Ordenação dos resultados. Pode ser "created_at", para ordenação decrescente por data de criação do post, ou "like", para ordenação decrescente por posts com mais likes. Default: "created_at".
user_id	opcional	Identificador do usuário para informação sobre likes (atributo "user_liked" fornecido na resposta). Default: IP do usuário.

API Response

data	Em caso de sucesso, será um objeto contendo os resultados da busca. O objeto contém as propriedades "results", "offset", "count" e "total".
status	O status da execução da chamada da API. Pode ser "success", se a busca foi realizada com sucesso ou "internal_server_error", caso algum erro desconhecido aconteça.

Example

Retorna os últimos posts moderados para a hashtag "focacbt", com as opções default:

 var handler = function(response) {
    if (response.status == "success") {
       console.log(response.data.results);
    } else {
       alert("Não foi possível realizar a busca.");
    }
 }
 var appId = 1;
 socialid.selfie.init(appId);
 socialid.selfie.posts('focacbt', handler);

Retorna os últimos posts moderados para a hashtag "focacbt", com opções customizadas:

 var handler = function(response) {
    if (response.status == "success") {
       console.log(response.data.results);
    } else {
       alert("Não foi possível realizar a busca.");
    }
 }
 var appId = 1,
      options = {
        page: 2,
        limit: 40,
        order: 'like',
        user_id: '50.97.87.253'
      };
 socialid.selfie.init(appId);
 socialid.selfie.posts('focacbt', handler, options);

Exemplo de dados no objeto "data":

 data = {
   count: 1,
   offset: 0,
   results: [{
     created_at: "2014-08-28T15:32:20+00:00",
     display_name: "jennyffer.suellen",
     likes: 0,
     message: "Foca no iguana #focacbt",
     picture_url: "http://scontent-b.cdninstagram.com/hphotos-xfa1/t51.2885-15/10632020_1540533216169293_1066110938_n.jpg",
     post_id: 3,
     post_url: "http://instagram.com/p/sP0HM_jwVv/",
     provider: "instagram",
     user_liked: true
   }],
   total: 1
 }