Introdução
O portal de desenvolvedores da Sompo pretende disponibilizar nossos produtos e serviços digitais para o mercado de seguros. O Portal Developers Sompo permitirá que o desenvolvedor conexão direta com serviços no ambiente de sandbox e através de uma documentação (swagger) com a explicação de cada API.
Para entregar esses benefícios ao consumidor, a Sompo operacionaliza e padroniza o compartilhamento das informações com privacidade e segurança.
Ambientes Sompo
A utilização de ambientes isolados garantem que as práticas de gerenciamento de APIs sejam aplicadas às diferentes fases, com controle de qualidade, garantindo segurança e eficiência.
Ambiente | URL |
---|---|
Desenvolvimento | https://api.sompo.com.br/dev |
Homologação | https://api.sompo.com.br/qa |
SandBox | https://api.sompo.com.br/sandbox |
Produção | https://api.sompo.com.br |
Access-Token (Mais informações no menu Autenticação) | https://api.sompo.com.br/oauth/access-token |
Integração
A integração das APIs consiste em trafego sobre o protocolo HTTPS, todo consumo de API consistem em dois passos básicos, primeiro, a obtenção de token de acesso (access-token), o segundo, é o consumo da API desejada usando o token de acesso.
Todas as APIs são configuradas, com códigos de request e response padrões e timeout. em caso de ocorrência, devem ser previamente verificadas se os padrões estão sendo seguidos, antes de submeter outra chamada.
Os tokens tem tempo período de validade curto, havendo necessidade, deve-se solicitar um novo a partir do serviço de obtenção de token.
Para mais detalhes, acesse a página Autenticação que contem um diagrama de sequência e um exemplo completo.
Segurança
As APIs disponíveis no Portal de Developers Sompo, exigem no transporte de informações o protocolo HTTP - TLS 1.2+, que fornece segurança na comunicação sobre a rede física.
Toda a estrutura do Portal de Developers Sompo possui segurança física a partir de soluções de Firewall.
Todos os acessos são gerenciados, com perfis de acessos distintos e com controles de throlling, quotas e outros.
Versionamento
As APIs usam o padrão de versionamento baseado em 'Versão' e 'Revisão'.
Sendo que cada uma delas, pode estar em diferentes versões ou revisões. (Ex API A pode estar em homologação na sua revisão 5, mas em produção a revisão 4 está ativa)
A evolução das versões, podem ser verificadas individualmente e o padrão para registro de novas implementações é o incremento numeral (Ex. v1, v2, v3).
A evolução das revisões, pode ser verificadas no swagger (contrato).
Ferramentas do Desenvolvedor
Acesse a página de ferramentas onde você encontrará as APIs que você tem acesso, e a um ambiente de Sandbox para fazer chamadas as APIs.
Publicação de APIs
Acesse a página de Publicação de APIs para encontrar a documentação com as orientações de publicação das APIs da Sompo.
Nossas API´s
APIs disponiveis para consumo pelos parceiros da Sompo, não encontrou o que precisa, faça uma busca pelas APIs expostas no Portal Developers Sompo
API | Resumo | Versão Atual |
---|---|---|
Apólices | Obtenção de informações de Apólice | v1 - Rev 12 |
Corretores | Obtenção de informações de Corretores | v1 - Rev 6 |
Financeiro | Informações sobre dados financeiros (posição de débitos, boletos, etc) | v1 - Rev 6 |
Segurados | Informações sobre dados cadastrais e bancários (vincular contas, atualizar cadastro) | v1 - Rev 10 |
Sinistros | Serviços para abertura e acompanhamento de sinistros | v1 - Rev 19 |
Cotação | Cotação/Propostas de seguros de diversos ramos | v1 - Rev 42 |
Open Insurance | AP´s para integração de congeneres e segurados | v1 |