Consulta ou responde um convite pelo link do e-mail
POST/user/invite
Endpoint público, sem token JWT: a prova é o Token do link do convite enviado por e-mail. O token vai sempre no corpo, nunca na URL (no link do e-mail ele fica depois do #, parte que o navegador não envia ao servidor).
O convite nasce no POST /user quando a pessoa cadastrada já tem vínculo em outra conta (ativo, inativo ou bloqueado): o vínculo com a conta que convidou fica pendente (Status 3) até a própria pessoa aceitar. O convite vale por 7 dias; um reenvio gera um link novo e invalida os anteriores.
view: mostra de quem é o convite e o estado dele, sem alterar nada. O e-mail vem mascarado e nenhum ID é exposto.accept: ativa o vínculo (Status3 → 1) e aplica os perfis de acesso escolhidos no cadastro. Exige o convite pendente e no prazo, e o usuário e a conta ativos. Depois de aceitar, a pessoa precisa entrar de novo para acessar a nova conta: a lista de contas do token JWT só muda no login.decline: recusa. O vínculo continua emStatus3 (a conta que convidou não ganha poder sobre a pessoa) e a data da recusa segura um novo convite por 30 dias. A conta tira a linha comDELETE /user/{iduser}. Vale também para convite vencido. Depois de uma recusa, a mesma conta só pode convidar a pessoa de novo após 30 dias.
Responder um convite cancela os outros links pendentes do mesmo vínculo. Pelo app, com o usuário logado, use PUT /user/invite.
Request
Responses
- 200
- 400
Com view, o convite (UserInviteView). Com accept ou decline, a resposta gravada (UserInviteAnswerResult).
Erros (prefixo [BadRequest]):
Convite não encontrado(token inexistente ou fora do formato, ou convite de outra pessoa)Não foi possível consultar o convite (<código>)Ação inválida: use accept ou declineEste convite já foi aceitoEste convite já foi recusadoEste convite foi cancelado ou substituído por um mais novo. Peça um novo convite à conta <empresa>Este convite expirou. Peça um novo convite à conta <empresa>(só noaccept: a recusa de convite vencido é aceita)Seu usuário ou a conta que convidou está desativado. Fale com o suporte(só noaccept)Este convite não está mais pendente. Atualize a página(outra resposta, um cancelamento ou o fim do prazo chegou antes)Não foi possível registrar a resposta (<código>)Não foi possível registrar a resposta