Visão Geral

Como acessar nossas APIs

Disponibilizamos abaixo um tutorial com os primeiros passos necessários para acessar as nossas APIs.

  1. Selecione a opção “Cadastre-se” no topo da página.
  2. O sistema apresentará a página para criação de nova conta. Preencha os campos solicitados e selecione a opção “Criar Nova Conta”.
  3. Neste momento, o sistema irá efetivar o cadastro e realizar o login no portal. Um e-mail de confirmação será enviado e você será direcionado para a home do Portal do Desenvolvedor.
  4. Selecione a opção “APPs” que foi disponibilizada no topo da página. O sistema irá direcioná-lo para uma lista de acessos vazia.
  5. Selecione a opção “Cadastrar nova APP”. O sistema exibirá uma página para cadastro.
  6. Preencha as informações solicitadas e selecione a opção “Registrar”. Seu APP estará criado.
  7. Para disponibilizarmos o acesso ao ambiente em Produção solicitaremos o client_id gerado no cadastro da sua APP, reserve esta informação.

As APIs disponibilizadas no ANBIMA Feed utilizam o protocolo OAUTH2 para realizar a autenticação e autorização de acesso das APIs contratadas

Após realização dos passos indicados acima, é o momento de obter o access_token, que permitirá o acesso às APIs da ANBIMA. Para isso, é necessário ter em mãos o client_id e o client_secret gerados para sua APP.

Na prática, é necessário realizar a chamada abaixo para nossa API de OAuth:

POST
https://api.anbima.com.br/oauth/access-token
HEADER
Content-Type: application/json
Authorization: Basic base64(client_id:client_secret)
REQUEST BODY
{
        "grant_type": "client_credentials"
}

As informações passadas para o campo Authorization devem ser codificadas em base 64. Por exemplo, para gerar o header Authorization do par client_id = aC2yaac23 e client_secret = 1bhS45TT, deve ser gerada a base64 da string aC2yaac23:1bhS45TT, que resultará na chave exemplo YUMyeWFhYzIzOjFiaFM0NVRU. Desta forma, o header deveria ser: ‘Authorization’: ‘Basic YUMyeWFhYzIzOjFiaFM0NVRU’.

Após a realização desta chamada, deverá ser obtida a seguinte resposta de API de OAuth 2.0:

{
	// O access_token gerado deve ser armazenado para ser utilizado nas chamadas à API	"access_token": "222rkya88",
	"token_type": "access_token",
	"expires_in": 3600
}

Na resposta, é indicado o tempo de expiração em segundos para o access_token. Após sua expiração, o mesmo procedimento indicado deve ser repetido para obtenção de um novo token.

Agora sua aplicação pode finalmente realizar chamadas às APIs utilizando os endpoints de Sandbox (teste) e Produção.

Caso tenha interesse em acessar as APIs do ANBIMA Feed no ambiente de Produção, entre em contato com:
anbimafeed@anbima.com.br