Blogs

Blogs

Serviço que permite a gestão de blogs alojados no blogs.sapo.pt

Subscrição gratuita

Descrição Técnica

Serviço Blogs

Pesquisa de posts no Sapo Blogs que contenham ou estejam relacionados a uma determinada expressão. A expressão pode ser composta por uma simples palavra ou por um conjunto de palavras separados pelo símbolo "+".

Manual de Referência da API

Serviço Operação Descrição
Blogs CommentApprove Aprovar um determinado comentário
CommentDelete Remover um comentário e todas as suas respostas
DraftCreate Cria um novo rascunho
DraftDelete Apaga um rascunho.
DraftFetch Retorna um rascunho.
DraftList Retorna a lista de rascunhos.
DraftPublish Publica um rascunho
JSON Pesquisa de posts que contenham ou estejam relacionados com a expressão social e devolve o resultado no formato JSON
LastComments Devolve uma lista de comentários ordenada por ordem inversa de publicação, isto é, os últimos comentários publicados primeiro
LastPosts Retorna uma lista de posts de um blog.
ListBlogs Devolve uma lista de blogs, ordenada por data de subscrição inversa, isto é, os últimos blogs subscritos primeiro
PostCreate Publica um artigo (post) dum blog
PostRemove Apaga um artigo (post) de um blog
PostUpdate Actualiza um artigo (post) num blog
PublicProfile Devolve o perfil púbico de um utilizador
RSS Pesquisa de posts de blogs que contenham ou estejam relacionados com a expressão social, no formato RSS

Serviço Blogs

CommentApprove

Aprovar um determinado comentário
Voltar ao topo

CommentDelete

Remover um comentário e todas as suas respostas
Voltar ao topo

DraftCreate

Cria um novo rascunho
Voltar ao topo

DraftDelete

Apaga um rascunho.
Voltar ao topo

DraftFetch

Retorna um rascunho.
Voltar ao topo

DraftList

Retorna a lista de rascunhos.
Voltar ao topo

DraftPublish

Publica um rascunho
Voltar ao topo

JSON

Pesquisa de posts que contenham ou estejam relacionados com a expressão social e devolve o resultado no formato JSON
Voltar ao topo

LastComments

Devolve uma lista de comentários ordenada por ordem inversa de publicação, isto é, os últimos comentários publicados primeiro
Voltar ao topo

LastPosts

Retorna uma lista de posts de um blog.
Voltar ao topo

ListBlogs

Devolve uma lista de blogs, ordenada por data de subscrição inversa, isto é, os últimos blogs subscritos primeiro
Voltar ao topo

PostCreate

Publica um artigo (post) dum blog
Voltar ao topo

PostRemove

Apaga um artigo (post) de um blog
Voltar ao topo

PostUpdate

Actualiza um artigo (post) num blog
Voltar ao topo

PublicProfile

Devolve o perfil púbico de um utilizador
Voltar ao topo

RSS

Pesquisa de posts de blogs que contenham ou estejam relacionados com a expressão social, no formato RSS
Voltar ao topo

Autenticação da API REST

Autenticação de um pedido REST

Cada pedido deverá conter informação de autenticação para estabelecer a identidade de quem fez o pedido e o token de autorização chamado ESB AccessKey (chave de acesso).

ESB Access Key

A autorização do uso da API é efectuada através da chave de acesso (ESB Access Key) que é disponibilizada no final do processo de compra do produto. Poderá gerar uma ESB Access Key para utilização da API nos detalhes do producto disponível na sua área de cliente.

O elemento ESBAccessKey deverá estar presente no URL como query-string

Exemplo HTTP GET usando nome do utilizador e palavra-chave:

Exemplo HTTP POST usando nome do utilizador e palavra-chave:

Request with ESBToken

Using a token instead of your username and password can be useful if you don't want to give your credentials to whom is using the API.

In order to generate a ESB Token you must use SAPO Security Token Service. You can generate a revocable token or a temporary token valid for 12 hours.

Exemplo HTTP GET usando um ESB Token:

Exemplo HTTP POST usando um ESB Token:

Descrição dos parâmetros:

ESBCredentials são parâmetros usados para autenticar e autorizar o pedido REST.

Elemento Descrição
ESBUsername O email da conta usada para para acederà API.
ESBPassword A palavra-passe que corresponde à conta de email especificada em ESBUsername.
ESBToken O token de acesso que representa as credenciais (ESBUsername + ESBPassword) usadas para comprar o uso da API.
ESBAccessKey O token que vai autorizar o pedido. A conta utilizada deve estar associada a este token.
Voltar ao topo