Nunciatura Provista

API Documentation V1

Alterar Senha de Administrador

Define nova senha para um administrador sem envio de email

Este endpoint é do tipo: Protected

Descrição

Altera a senha de um administrador específico diretamente pelo painel:

  • Recebe password e password_confirmation
  • Substitui a senha anterior sem enviar email
  • Define must_change_password = false
  • Requer autenticação JWT válida de administrador

Detalhes do Endpoint

VERBO

POST

URL BASE

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

ENDPOINT

/users/{id}/change-password

Parâmetros da URL

Parâmetro Tipo Descrição
id string (UUID) UUID do administrador (users.id)

Corpo da Requisição

Campo Tipo Obrigatório Descrição
password string Sim Nova senha (mín. 6 caracteres, 1 maiúscula, 1 minúscula, 1 número)
password_confirmation string Sim Confirmação da nova senha

Exemplo de Requisição

POST /v1/users/b033e2ff-4114-5bgg-9797-e8bfc6c162d0/change-password
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

{
  "password": "NovaSenha123",
  "password_confirmation": "NovaSenha123"
}

Respostas

Sucesso - 200

{
  "success": true,
  "message": "Senha alterada com sucesso. O administrador pode fazer logoff e entrar com a nova senha."
}

Erro - 404 (Administrador não encontrado)

{
  "success": false,
  "message": "Administrador não encontrado"
}

Erro - 422 (Validação)

{
  "message": "Os dados fornecidos são inválidos.",
  "errors": {
    "password": ["A confirmação da senha não corresponde."]
  }
}