front_ponto_eletronico/docs/users/create.yml
2025-03-17 15:00:51 -03:00

79 lines
2.2 KiB
YAML

Criar usuário ou subordinado
---
tags:
- Users
summary: Criação de usuário ou subordinado vinculado a um usuário responsável
description: >
Este endpoint permite criar um usuário ou subordinado vinculado a um usuário responsável.
parameters:
- in: body
name: body
required: true
description: Dados do usuário ou subordinado a serem criados.
schema:
type: object
required:
- username
- email
- password
- responsible_id
properties:
username:
type: string
description: Nome de usuário ou subordinado.
example: subordinate_user
email:
type: string
description: E-mail.
example: subordinate@example.com
phone:
type: integer
description: Número de telefone (opcional).
example: 5511999999999
password:
type: string
description: Senha.
example: securepassword123
profile_image:
type: string
description: URL da imagem de perfil (opcional).
example: https://example.com/profile.jpg
birth_date:
type: string
format: date
description: Data de nascimento (opcional).
example: 1990-01-01
parent_id:
type: integer
description: ID do usuário responsável (opcional).
example: 1
responses:
201:
description: Usuário criado com sucesso.
schema:
type: object
properties:
message:
type: string
example: Usuário criado com sucesso.
subordinate_id:
type: integer
example: 42
400:
description: Erro na criação do Usuário.
schema:
type: object
properties:
error:
type: string
example: Usuário já existe.
401:
description: Não autorizado.
schema:
type: object
properties:
error:
type: string
example: Token inválido ou expirado.