👤 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

{
  "email": "ana@example.com",
  "full_name": "Ana Silva",
  "password": "StrongP@ssw0rd",
  "phone": "+55 11 99999-0000"
}

200

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

✏️ Atualizar usuário

PATCH /users

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

Body

{
  "email": "ana@example.com",
  "first_name": "Ana",
  "last_name": "Silva",
  "username": "ana.silva",
  "document": "123.456.789-00",
  "phone": "+55 11 98888-7777",
  "full_name": "Ana Carla Silva"
}

200

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

🗑️ Deletar usuário

DELETE /users

Body

{ "email": "ana@example.com" }

200

{ "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

{ "email": "ana@example.com" }

200

{
  "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