Registar utilizadores, verificar emails, emitir tokens, recuperar acesso e consultar o perfil do utilizador autenticado.
Registar utilizador
Método e rota: POST /api/auth/register. Cria uma nova conta de utilizador no IZI Pay Identity. Use este endpoint no início do onboarding e depois oriente o utilizador pela verificacao de email antes de depender da conta para operações protegidas.
Registar utilizador › Request Body
emailpasswordfirstNamelastNamephoneNumberRegistar utilizador › Responses
Registo de utilizador aceite.
messageVerificar endereço de email
Método e rota: POST /api/auth/verify-email. Confirma que o utilizador controla o email usado no registo. Envie o token de verificacao exatamente como foi recebido no fluxo de verificacao de email.
Verificar endereço de email › Responses
Email verificado.
messageObter token de acesso
Método e rota: POST /connect/token. Use este endpoint quando uma aplicação ou utilizador precisa de um token de acesso. A mesma rota suporta client credentials para chamadas servidor-a-servidor e login por palavra-passe para fluxos de utilizador confiáveis.
Obter token de acesso › Request Body
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: grant_type, client_id, client_secret +1 more | |
| type = object · requires: grant_type, username, password +2 more |
grant_typeclient_idclient_secretscopeObter token de acesso › Responses
Token emitido com sucesso.
access_tokenrefresh_tokenexpires_intoken_typeObter informações do utilizador
Método e rota: GET /connect/userinfo. Devolve os dados de perfil do utilizador representado pelo bearer token. É útil depois do login quando a aplicação precisa de detalhes de identidade sem os guardar localmente.
Obter informações do utilizador › Responses
Dados de perfil do utilizador.
subemailnameIniciar recuperação de palavra-passe
Método e rota: POST /api/auth/forgot-password. Inicia o processo de recuperação de palavra-passe para um utilizador que não consegue iniciar sessão.
Iniciar recuperação de palavra-passe › Responses
Fluxo de recuperação de palavra-passe iniciado.
messageRedefinir palavra-passe
Método e rota: POST /api/auth/reset-password. Conclui a recuperação trocando um token válido por uma nova palavra-passe. Trate tokens de recuperação como segredos de curta duração.
Redefinir palavra-passe › Request Body
tokennewPasswordRedefinir palavra-passe › Responses
Palavra-passe redefinida.
message