1.    Autenticação

Para acessar as APIs da Susep, as empresas precisam ter um cliente válido. Caso sua empresa ainda não tenha um cliente entre em contato com cgraj.rj@susep.gov.br.

A autenticação é feita utilizando JSON Web Tokens – JWT. Para obter um desses tokens de administração, é necessário fazer uma requisição conforme a demonstrada abaixo:

O retorno dessa requisição é conforme o abaixo:

O access_token deverá ser armazenado para fazer as requisições autenticadas à API.

O access_token expira 1 hora após ter sido emitido.

2.    Requisições

Uma requisição autenticada deve ser conforma a imagem abaixo:

No campo em vermelho, seguido do texto “Bearer” deve ser adicionado o access_token obtido durante o processo de autenticação.

3.    APIs disponíveis

Até o momento, o sistema de corretores disponibiliza apenas duas consultas:

3.1.           Consulta aos dados de um corretor por vez

Endereço: https://www2.susep.gov.br/safe/corretoresapig/seguradoras/corretor/11111111111

Onde tem 11111111111, deverá ser inserido o CPF do corretor sem qualquer formatação

3.2.           Download da base de corretores

Endereço: https://www2.susep.gov.br/safe/corretoresapig/seguradoras/baixarArquivo

Não recebe qualquer parâmetro e retorna um arquivo zip com os dados de todos os corretores.