Guia de integração rápida do Abril ID para sites terceiros para a orientação de desenvolvedores
Legenda:
- * Campos Obrigatórios
- obj Retorna postMessage ou window location; É retornado um JSON nos demais métodos.
Métodos
Método para cadastro de novos usuários no sistemas de autenticação
https://authp.abril.com.br/services/auth/
[payload]
- Método = cadastro
- email *
- password *
- confirmPassword *
- firstName *
- lastName *
- urlRetorno
[response]
{
status: success,
msg: O cadastro foi feito com sucesso. Aguardando ativação de conta
}
[error]
{
status: error,
msg: “Este e-mail já está registrado, clique aqui para entrar | Senhas não conferem | Erro ao cadastrar usuário”
}
Método para verificar se o usuário já está cadastrado com o e-mail especificado, se email verificado valido, enviar codigo de verificação se email ja existir na base de dados ou invalido exibe mensagem de erro.
https://authp.abril.com.br/services/auth/
[payload]
- Método = checaUsuarioCadastrado
- email *
[response]
{
status: success,
msg:”
}
[error]
{
status: error,
msg: “Erro ao verificar o cadastro”
}
{
status: “error”,
msg: “Este e-mail já está registrado, clique aqui para entrar.”,
field: “email”
}
{
status: “error”,
msg: “Ocorreu um erro ao validar o e-mail”,
field: “email”
}
Método para confirmação de usuário, quando usuario logado envia codigo de confirmação para o email, validando o codigo, libera acesso no Abril ID, se erro exibe mensagem de erro.
https://authp.abril.com.br/services/auth/
[payload]
- Método = confirmCadastro
- email *,
- confirmCode *,
- urlRetorno
[response]
obj:
{
action: acessar,
status: success,
urlRetorno: editar-conta
}
[error]
obj:
{
action: acessar,
status: error,
urlRetorno: status=error&msg=Erro ao confirmar o cadastro
}
Método para login do usuário, se login valido loga usuario no Abril ID, se não exibe mensagem de erro.
https://authp.abril.com.br/services/auth/
[payload]
- Método = login
- email *,
- password *,
- urlRetorno
[response]
obj:
{
action: acessar,
status: success,
urlRetorno: editar-conta
}
[error]
obj:
{
action: acessar,
status: error,
urlRetorno: acessar
}
obj:
{
action: migrate,
status: error,
urlRetorno: nova-senha-migrados
}
Método que verifica usuários migrados de sites terceiros.
https://authp.abril.com.br/services/auth/
[payload]
- Método = userInfo
- email *,
- password *
[response]
{
status: success,
msg:
{
first_name: “Primeiro Nome”,
last_name: “Sobrenome”,
email: “email@email.com”
}
}
[error]
{
status: error,
url: conta_inativa,
msg: Credenciais inválidas
}
{
status: error,
url: credenciais_invalidas,
msg: Conta migrada, necessita troca de senha
}
{
status: error,
url: bloqueio_temporario,
msg: Limite de tentativas excedido. Tente novamente em alguns minutos.
}
Método que desloga Usuario do sistema.
https://authp.abril.com.br/services/auth/
[payload]
- Método = logout
- urlRetorno,
- loadCard
[response]
obj:
{
action: ‘logout’,
status: ‘success’,
urlRetorno: acessar
}
obj:
{
action: ‘logout_card’,
status: ‘success’
}
[error]
{
status: error,
msg: Voce ainda está Logado | Você não está logado | Você está logado
}
Método que recupera o token de acesso, verificando se usuario esta logado no sitema.
https://authp.abril.com.br/services/auth/
[payload]
- Método = regenerateAccess
- refreshtoken
[response]
{
status: ‘success’,
msg: Usuário logado com sucesso
}
[error]
{
status: ‘error’,
msg: ‘Erro ao atualizar token’
}
{
status: ‘error’,
msg: ‘Erro ao atualizar’
}
Método que cria um novo token de acesso, se token criado é valido usuario se loga com sucesso.
https://authp.abril.com.br/services/auth/
[payload]
- – Método = getAccessToken
- refreshtoken
[response]
{
status: ‘success’,
msg: Usuário logado com sucesso
}
[error]
{
status: ‘error’,
msg: ‘Erro ao atualizar token’
}
Método que Retorna os dados do usuário logado.
https://authp.abril.com.br/services/auth/
[payload]
- Método = getUsuario
- accessToken
[response]
obj:
{
UserId: ID Usuario,
UserName: email@email.com.br,
firstName: “Primeiro Nome”,
lastName: “Sobrenome”
}
[error]
obj:
{
status: ‘error’,
msg: false}
Este Método Faz a requisição no serviço para atualizar os dados do usuario no Abril ID.
https://authp.abril.com.br/services/auth/
[payload]
- Método = updateUsuario
- email *
- newEmail *
- confirmNewEmail *
- passwordCheck *
- oldPassword *
- newPassword *
- confirmNewPassword *
- firstName *
- secondName
- lastName *
- nickName
- gender
- cpf *
- cnpj *
- birthdate
- endereco
- numero
- cep
- complemento
- bairro
- cidade
- estado
- sectionUpdate
- urlRetorno
[response]
obj:
{
status: success,
msg: Cadastro atualizado com sucesso!
}
[error]
obj:
{
status: error,
sectionUpdate: identidadeSection,
msg: Primeiro nome não pode ser vazio | Nome inválido. | Último nome não pode ser vazio. | Último nome inválido.
}
obj:
{
status: error,
sectionUpdate: emailSection,
msg: O e-mail antigo não pode ser vazio. | O novo e-mail não pode ser vazio. | A confirmação de email não pode ser vazia. | A confirmação da e-mail é diferente.
}
obj:
{
status: error,
sectionUpdate: perfilSection,
msg: Primeiro nome não pode ser vazio | Nome inválido. | Último nome não pode ser vazio. | Último nome inválido. | Apelido inválido. | O CPF está com o valor inválido. | CPF incorreto | CNPJ Incorreto | CNPJ incorreto. | Data de nascimento está com valor inválido. | Data de Fundação está com valor inválido.
}
obj:
{
status: error,
sectionUpdate: enderecoSection,
msg: CEP inválido. | Endereço inválido. | Número inválido. | Complemento inválido | Complemento inválido. | Bairro inválido. | Bairro inválido. | Cidade inválida. | Estado inválido.
}
obj:
{
status: error,
sectionUpdate: segurancaSection,
msg: Senha atual não pode ser vazia. | A confirmação da senha é diferente.
}
Método para verificar no middleware se o usuário esta logado.
https://authp.abril.com.br/services/auth/
[payload]
- Método = verifyUserLoged
[response]
obj:
{
status: success,
msg: Usuário logado
}
[error]
obj:
{
status: ‘error’,
msg: Inconsistência nos dados, por favor, logue novamente. | O usuário não esta logado.
}
Método para gerar código de renovação de senha do usuário e enviar por e-mail,
https://authp.abril.com.br/services/auth/
[payload]
- Método = forgotPassword,
- email *
[response]
obj:
{
status: success,
msg:”
}
[error]
{
status: ‘error’,
field: email,
msg: E-mail não cadastrado. | Sua conta não foi ativada, clique aqui para fazer a validação. | Muitas tentativas no mesmo email
}
Método que reenvia código de ativação de conta,
https://authp.abril.com.br/services/auth/
[payload]
- Método = resendCode,
- email *
[response]
obj:
{
status: success,
msg: E-mail reenviado com sucesso.
}
[error]
{
status: ‘error’,
msg: E-mail inválido | Você só pode enviar nova mensagem daqui a 15 minutos | Essa conta já foi ativada, tente recuperar sua senha
}
Método para confirmação de reset de senha do usuário através do código gerado no Método anterior
https://authp.abril.com.br/services/auth/
[payload]
- Método = confirmForgotPassword,
- email *,
- confirmCode *,
- newPassword *,
- confirmNewPassword *,
- urlRetorno
[response]
{
action: acessar,
status: success,
msg: Senha alterada com sucesso}
obj:
{
action: acessar,
status: success,
urlRetorno: editar-conta
}
[error]
{
status: ‘error’,
msg: Código inválido. Verifique seu e-mail.
}
{
action: acessar,
status: error,
msg: Código inválido. Verifique seu e-mail.,
field: confirmCode,
urlRetorno: /nova-senha/erro/codigo-invalido
}
{
action: acessar,
status: error,
msg: Código inválido. Verifique seu e-mail.,
field: email,
urlRetorno:/nova-senha/erro/codigo-email-invalido
}
{
action: acessar,
status: error,
msg: Muitas tentativas no mesmo email.,
field: email,
urlRetorno: /nova-senha/erro/acessos
}
{
action: acessar,
status: error,
msg: Senhas não conferem,
field: email,
urlRetorno: /nova-senha/erro/senhas
}
Método que habilita o usuário a usar a rede social na conta padrão
https://authp.abril.com.br/services/auth/
[payload]
- Método = linkUserSocialLogin
[response]
{
status: success,
msg: Usuário cadastrado com sucesso.
}
[error]
{
status: error,
msg: Não foi possível associar usuário ao perfil da rede social
}
Método que registra usuário com o login de rede social
https://authp.abril.com.br/services/auth/
[payload]
- Método = socialSignIn,
- identityProvider *,
- urlRetorno,
- accessToken *
[response]
{
status: success,
msg: Usuário cadastrado com sucesso.
}
[error]
{
status: error,
msg: E-mail já existente.
}
Método para login do usuário via rede social
/services/auth
[payload]
- Método = socialLogin,
- identityProvider *,
- urlRetorno,
- accessToken *
[response]
{
status: success,
email: email@email.com.br,
username: email@email.com.br,
password: Senha do Usuario
}
[error]
{
status: error,
msg: Erro ao identificar o usuário na rede social.
}{
status: error,
msg: E-mail já existente.
url: acessar/erro/email-existente
}
Método para update do Avatar(Foto de Perfil)
https://authp.abril.com.br/services/auth/
[payload]
- Método = updateAvatar,
- urlAvatar *
[response]
obj
{
action: edicao_avatar,
status: success,
msg: Avatar atualizado com sucesso
}
[error]
obj
{
action: edicao_avatar,
status: error,
msg: Erro ao atualizar o Avatar do usuário.
}