Primeiros passos

Explore a documentação da API para se familiarizar com as rotas disponíveis e como elas podem ser utilizadas na emissão de seguros diretamente na experiência dos seus clientes.

O fluxo geral de emissão consiste em:

1. Fazer uma cotação
2. Criar uma proposta com a cotação obtida, com detalhes do cliente final e risco segurado
3. Atualizar a proposta se houver pendências a serem resolvidas
4. Consultar emissões realizadas uma vez que a proposta esteja completa

Também temos rotas para consultar quais produtos estão disponíveis para o seu canal, para solicitar cancelamentos de propostas e emissões (vendas), acessar PDFs e gerenciar assinaturas de webooks para notificações em tempo real.

Para iniciar a integração com a API, entre em contato com o time da 180 para obter suas credenciais e fazer chamadas reais em nosso ambiente de staging que se comporta como o ambiente de produção.

Autenticação

Sagas API usa o fluxo OAuth2 client credentials para autenticação. Você receberá um client_id e um client_secret que são usados na obtenção de um token de acesso que precisa ser enviado em todas as chamadas de API.

Para obter um token de acesso, realize uma chamada como abaixo (ou equivalente em sua linguagem de preferência):

curl --request POST \
  --url https://180s-staging.us.auth0.com/oauth/token \
  --header 'content-type: application/json' \
  --data '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "client_credentials"
  }'

Inclua o token de acesso no cabeçalho de autenticação de todas as chamadas:

headers = {
  "Authorization": "Bearer SEU_TOKEN_DE_ACESSO",
  "Content-Type": "application/json"
}

🚧

Reutilize os tokens de acesso enquanto forem válidos

Garanta que os tokens de acesso sejam reutilizados durante toda a sua validade (por padrão, 12 horas). Obter tokens desnecessariamente pode resultar em limitações nas chamadas.