👤 Usuários

👤 Users

Gerencie usuários via API pública.

Todos os endpoints exigem:

• Authorization: Bearer {token}
• X-Requested-With: XMLHttpRequest
• Content-Type: application/json

Recursos do plano necessários:

• Public API – Create User
• Public API – Update User
• Public API – Delete User
• Public API – Reset User Password

---

➕ Criar usuário

POST /users

Body

JSON

{
  "email": "[email protected]",
  "full_name": "Ana Silva",
  "password": "StrongP@ssw0rd",
  "phone": "[phone]"
}

200

JSON

{ "message": "Usuário criado com sucesso" }

---

✏️ Atualizar usuário

PATCH /users

Identifica o usuário por email e atualiza os demais campos.

Body

JSON

{
  "email": "[email protected]",
  "first_name": "Ana",
  "last_name": "Silva",
  "username": "ana.silva",
  "document": "123.456.789-00",
  "phone": "[phone]",
  "full_name": "Ana Carla Silva"
}

200

JSON

{ "message": "Usuário atualizado com sucesso" }

---

🗑️ Deletar usuário

DELETE /users

Body

JSON

{ "email": "[email protected]" }

200

JSON

{ "message": "Usuário deletado com sucesso" }

---

🔐 Redefinir senha

POST /users/reset-password

Envia o e-mail de redefinição e retorna a URL gerada (reset_url).

Body

JSON

{ "email": "[email protected]" }

200

JSON

{
  "message": "Password reset link sent successfully",
  "reset_url": "https://sua-plataforma.ensinio.cloud/password/reset/eyJ0b2tlbiI6..."
}

Erros comuns

• 400 — validação (e.g. email inválido)
• 401 — token ausente/inválido
• 403 — feature desabilitada no plano
• 404 — usuário não encontrado
• 429 — rate limit
• 500 — erro inesperado