Nunciatura Provista

API Documentation V1

Alterar Senha

Troca obrigatória de senha temporária no primeiro acesso

Este endpoint é do tipo: Protected

Descrição

Permite que o usuário autenticado altere sua senha. Usado principalmente no primeiro acesso de informadores, quando requires_password_change é true após o login.

  • Requer token JWT válido
  • Valida a senha atual (temporária ou definida pelo admin)
  • Define nova senha pessoal com confirmação
  • Remove a flag must_change_password do usuário

Detalhes do Endpoint

VERBO

POST

URL BASE

http://api.provisao.nabrasil.org.br/v1

ENDPOINT

/auth/change-password

Cabeçalhos

Parâmetro Valor
Authorization Bearer <token>
Content-Type application/json

Campos Esperados

Campo Tipo Obrigatório Descrição
current_password string Sim Senha atual (temporária recebida por email ou definida pelo admin)
password string Sim Nova senha pessoal (mín. 6 caracteres, maiúscula, minúscula e número)
password_confirmation string Sim Confirmação da nova senha

Exemplo de Requisição

POST /api/auth/change-password
Authorization: Bearer <token>
Content-Type: application/json

{
  "current_password": "SenhaTemp123",
  "password": "MinhaSenhaPessoal1",
  "password_confirmation": "MinhaSenhaPessoal1"
}

Sucesso - 200

{
  "success": true,
  "message": "Senha alterada com sucesso.",
  "data": {
    "requires_password_change": false
  }
}