Conheça a documentação:

Essa documentação da Bullseye visa trazer informações a cerca de nossas funcionalidades e esclarecer eventuais dúvidas. Portanto, ela vai sendo construída por demanda, a medida que vamos precisando de trazer informações relevantes sobre integrações, APIs, utilitários, recursos, FAQs e o que mais for útil e relevante.

Esperamos que seja de fácil leitura e utilização, que permita um entendimento ampliado das funcionalidades.

Login e Cadastro de usuários

Esta integração é um SSO, que é usado para fazer login e cadastro de usuários na plataforma Bullseye.

Neste endpoint, temos a integração tanto de cadastro, quanto de login. Ao fazer a requisição HTTP do tipo POST um usuário é cadastrado caso não tenha cadastro, e feito o login automaticamente dentro da plataforma da Bullseye.

Ao ser feito o castro e/ou login, ele é redirecionado para a plataforma da Bullseye automaticamente.

Endpoint: https://{seu domínio ou subdomínio}/edudev/integration

Tipo de requisição:

Parâmetros possíveis na requisição:

• name: nome do usuário
• email: email do usuário
• phone: número de contato do usuário
• email: email do usuário
• cpf: CPF do usuário
• userHash: Hash de login, para identificação e autenticação do usuário
• accessToken: Token de acesso informado pela Bullseye

Os campos vistos acima cpf e userHash são obrigatórios para realização do login. Para o cadastro, todos os demais parâmetros (exceto pelo phone) são obrigatórios.

Exemplo de parâmetros de teste:

{
	"name": "Usuário Teste",
	"email": "teste.user@bullseye.com.br",
	"phone": "11933333333",
	"cpf": "70166634000",
	"userHash": "7815696ecbf1c96e6894b779456d330e",
	"accessToken": "F2"
}

Recomendações:

• Fazer a criação da hash do usuário (userHash) concatenando dados imutáveis dos usuários e com mais algum salt, pois este Hash deverá ser sempre o mesmo do cadastrado
• Criar o userHash no backend, e fazer a requisição ao endpoint também no backend, afim de esconder esses dados do usuário, por fator de segurança, não estando no frontend
• Chamada a API via POST, para que os dados da requisição fiquem o máximo transparente ao usuário
• Tratar o retorno do endpoint, escrevendo o mesmo em um log, a fim de ter um feedback a cerca de problemas com usuários
• Essas Recomendações não são responsabilidades da Bullseye