Serviço Captcha

Este serviço permite a geração e apresentação de um CAPTCHA customizável. Um CAPTCHA é um acrónimo de Completely Automated Public Turing test to tell Computers and Humans Apart, consistindo num teste usado para determinar se o utilizador é humano ou um bot. Permite a customização da fonte, cores e método de geração do CAPTCHA. A validação do CAPTCHA deverá ser feita dentro da aplicação. Após a geração é retornado um XML com o id e o código do CAPTCHA.

Descarregar Contrato OSD do Serviço

Descarregar Guia de Iniciação Rápida

Serviço	Operação	Descrição
Captcha	Get	Gerar um novo captcha
	Play	Reproduz captcha sonoro
	Show	Mostrar a imagem do captcha

Serviço

Get

Gerar um novo captcha

Voltar ao topo

Play

Reproduz captcha sonoro

Voltar ao topo

Show

Mostrar a imagem do captcha

Voltar ao topo

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