Token de Acesso
Um Token de Acesso é obtido através do Servidor de Autorização da ANS. O Console OAuth 2 provê uma interface WEB amigável para interação com o Servidor de Autorização. Este console está acessível à partir da opção “Console OAuth 2” no menu vertical localizado em “Área do Desenvolvedor -> APIs e Autorização”.
Console OAuth 2
Ao clicar na opção “Console OAuth 2”, é apresentada uma página conforme a imagem abaixo.
Clique na imagem para ampliá-la.
Caso a Operadora já possua algum token ativo, uma lista dos Clientes OAuth que obtiveram esses tokens será exibida contendo informações desses acessos. Também será apresentada a ação de “Revogar” todos os acessos daquele cliente.
Nesta página é possível obter um “Novo” Token de Acesso.
Obter um Novo Token de Acesso
Para obter um novo Token de Acesso, basta clicar em “Novo” e você será redirecionado para a página abaixo:
Clique na imagem para ampliá-la.
Nesta tela a Operadora autenticada estará carregada como “Usuário” (Resource Owner) do Token e será apresentado as opções de seleção do Cliente OAuth e Escopo, filtrados pelas APIs.
Após selecionar o Cliente e adicionar os Escopos, clique em “Obter Token” e será apresentado o Token de Acesso, conforme imagem abaixo:
Clique na imagem para ampliá-la.
Pronto! Agora basta copiar o Token de Acesso e utilizá-lo para acessar nossa API.
API OAuth
Seu aplicativo pode acessar diretamente o Servidor de Autorização OAuth 2 através de uma API Rest. Nesta API é possível obter um novo Token de Acesso ou revogar um token existente.
A documentação da API Rest do servidor encontra-se disponível em: https://www.ans.gov.br/apis/oauth2/
Lembre-se que o armazenamento ou repasse dos Tokens de Acesso é de inteira responsabilidade da Operadora.