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