Como consumir a API Manager?

Introdução

A API Manager continua funcional no API Management (Sensedia Platform), mas com algumas mudanças: a URL mudou e a forma de autenticação também.

Agora, a URL base é única:

https://platform-production.sensedia.com/api-manager/api/v3/

Para acessar as diversas operações disponíveis (consulte o Swagger para ver a listagem completa), você precisa sempre enviar um header Authorization com valor no formato:

Bearer <token>

É através do token que identificamos o tenant e devolvemos as informações corretas na chamada.

Resumindo

Nas chamadas, envie o header:

Authorization: Bearer <token>

Lembre-se de deixar um espaço entre "Bearer" e o token e substitua <token> pelo seu token de acesso (veja abaixo como gerá-lo).

Como gerar o token

Para gerar o token, você precisa de um client ID e de um client secret válidos. Para obtê-los, siga os passos abaixo.

Apenas usuários Super Admin podem gerar o token de acesso.
O token de acesso expira em 24 horas (86400 segundos).

Acesse o Access Control.
No canto superior direito, clique no nome do seu usuário e acesse a opção ACCOUNT SETTINGS:
Na aba CREDENTIALS, clique em GENERATE CREDENTIALS para gerar as credenciais.

Você então poderá visualizar e copiar o client ID e o client secret, exibidos como na imagem abaixo:

Após sair da aba, você poderá visualizar novamente o client ID, mas o client secret não ficará mais visível por questões de segurança. Guarde-o de forma segura ou revogue a credencial atual e gere uma nova, se necessário.

Gerando o token com curl

É necessário agora enviar essas credenciais ao servidor de autorização para gerar o token. Para facilitar, é disponibilizado um comando curl na tela, que pode ser usado diretamente no terminal, Postman ou em outro aplicativo.

O retorno desse comando conterá o token, como no exemplo abaixo:

{
  "access_token": "<token>",
  "expires_in": "86400",
  "token_type": "Bearer"
}

Uso do token

Copie o valor do campo "access_token" (seu token) e envie-o nas chamadas HTTP com o header:

Authorization: Bearer <token>

Assim, suas chamadas à API Manager funcionarão corretamente no API Management (Sensedia Platform).

Thanks for your feedback!

EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]