Como começar

Introdução

Sandbox

Com o objetivo de facilitar o desenvolvimento de soluções, o Banestes disponibiliza um ambiente de sandbox para possibilitar que as APIs sejam executadas em um local seguro com o objetivo de aplicar o conhecimento sobre as APIs do Dev. Portal, além de testar a aplicabilidade das suas funcionalidades e garantir que todas as regras definidas para o uso das APIs sejam consideradas, de forma que o seu negócio possa operar livre de erros.

No sandbox, uma aplicação pode executar as mesmas operações que executa em ambiente produtivo. Isso ajudará a entender qual estrutura deve ser utilizada em suas soluções. Contudo, não existe ligação entre os dados do ambiente sandbox com o ambiente de produção, logo, todas as informações retornadas nos testes serão fictícias, não havendo relação alguma com as suas informações produtivas.

Importante

Informações importantes sobre o ambiente de sandbox do Banestes:

  • Todos os fluxos de integração/comunicação são em APIs REST;
  • A documentação está em Swagger (OpenAPI);
  • Não armazenamos as informações inseridas em sandbox;
    • Caso armazene, as mesmas serão expurgadas em um dado momento.
  • O ambiente é mockado, ou seja, dados estáticos e fictícios.

Utilização

Acesso Sandbox

Para acessar o sandbox do Dev. Portal Banestes, também é necessária a utilização de um certificado. Isso se faz necessário pois queremos que o nosso ambiente de sandbox seja o mais próximo possível das exigências e funcionalidades do ambiente produtivo. Além do certificado, você também precisará das credenciais sandbox (client_id e client_secret) para geração de um access token válido.

O certificado e o access token são válidos apenas para acessar o nosso ambiente de sandbox, ou seja, você precisará de novas e exclusivas credenciais quando a sua aplicação estiver pronta para produção. Para saber mais sobre as autenticações necessárias para o ambiente produtivo, veja o nosso passo a passo de acesso à produção.

  1. Cadastre-se no Dev. Portal Banestes: https://desenvolvedores.banestes.com.br;
  2. Acesse a página para registrar uma APP e obter as credenciais para geração do access token (client_id e client_secret) do ambiente de sandbox;
    * É muito importante que preencha todas as informações do formulário de criação da APP;
  3. Siga os procedimentos para criação e registro de um certificado;
  4. Siga os procedimentos para geração de um access token, com as informações da APP de sandbox ou, quando for o momento, de produção;
  5. Siga os procedimentos para acessar as APIs Banestes com o access token e certificado;
  6. Navegue pelo nosso catálogo de APIs e explore as nossas documentações e possibilidades;
  7. Clique em ver especificação técnica, localizado no card da API, ou abra a API que deseja testar e clique no botão ver especificação técnica.
Português, Brasil