Blogs

Blogs

Service that allows management of blogs hosted at blogs.sapo.pt

Free subscription

Technical Overview

Blogs Service

Search for posts in Sapo Blogs that contain or are related to a given search expression. The expressin can be made by a single word or by a group of words separated by '+' symbol.

API Reference

Service Operation Description
Blogs CommentApprove Approves a certain comment
CommentDelete Removes a comment and all its answers
DraftCreate Create a new draft.
DraftDelete Delete a draft.
DraftFetch sapo:OpenSearchUrl
DraftList Get the list of drafts.
DraftPublish Publish a draft
JSON Search for blog posts containing or related with the expression social, in JSON format
LastComments Returns a list of comments ordered by inverse order of publication, this is, first the last published comments
LastPosts Returns a list of posts in a blog.
ListBlogs Returns a list of blogs, order by inverse subscription date, this is, first the last subscribed blogs
PostCreate Publishes an article (post) in a blog
PostRemove Removes an article (post) from a blog
PostUpdate Updates an article (post) in a blog
PublicProfile Retrieve public profile of a user
RSS Search for blog posts containing or related with the expression social, in RSS format

Blogs Service

Operations

CommentApprove

Approves a certain comment
Examples
Go to top

CommentDelete

Removes a comment and all its answers
Examples
Go to top

DraftCreate

Create a new draft.
Examples
Go to top

DraftDelete

Delete a draft.
Examples
Go to top

DraftFetch

sapo:OpenSearchUrl
Examples
Go to top

DraftList

Get the list of drafts.
Examples
Go to top

DraftPublish

Publish a draft
Examples
Go to top

JSON

Search for blog posts containing or related with the expression social, in JSON format
Examples
Go to top

LastComments

Returns a list of comments ordered by inverse order of publication, this is, first the last published comments
Examples
Go to top

LastPosts

Returns a list of posts in a blog.
Examples
Go to top

ListBlogs

Returns a list of blogs, order by inverse subscription date, this is, first the last subscribed blogs
Examples
Go to top

PostCreate

Publishes an article (post) in a blog
Examples
Go to top

PostRemove

Removes an article (post) from a blog
Examples
Go to top

PostUpdate

Updates an article (post) in a blog
Examples
Go to top

PublicProfile

Retrieve public profile of a user
Examples
Go to top

RSS

Search for blog posts containing or related with the expression social, in RSS format
Examples
Go to top

REST API Authentication

Authenticating REST Request

Every request must contain authentication information to establish the identity of whom making the request and a autorization token denominated ESBAccessKey.

ESB Access Key

The ESB Access Key is what will authorize the usage of the API and is available when the buying process ends. In the costumer area you can find the product details where you can generate an ESB Access Key for you usage, another user registered on SAPO Services or even for everyone.

The element ESBAccessKey must appear on the URL as a query-string

HTTP GET example using username and password:

HTTP POST username and password:

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. The ESBToken is valid for 12 hours.

HTTP GET example using ESB Token:

HTTP POST ESB Token:

Parameters description

ESBCredentials are parameters used to authenticate and authorize a REST request

Elements Description
ESBUsername The e-mail of the account that is used to access the API.
ESBPassword The password that in combination with the ESBUsername is used to access the corresponding account.
ESBToken An authentication token generated by using an user name (ESBUsername) and password (ESBPassword). It should be used a ESBToken or the combination of ESBUsername and ESBPassword.
ESBAccessKey The authorization key used to authorize the request against your purchase. The account being used to access the service must be associated to this key.
Go to top