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

73 lines
2.0 KiB
YAML

Criar usuário subordinado
---
tags:
- Users
summary: Criação de subordinado vinculado a um usuário responsável
description: >
Este endpoint permite criar um subordinado associado a um usuário responsável.
parameters:
- in: body
name: body
required: true
description: Dados do subordinado a serem criados.
schema:
type: object
required:
- username
- email
- password
properties:
username:
type: string
description: Nome de usuário do subordinado.
example: subordinate_user
email:
type: string
description: E-mail do subordinado.
example: subordinate@example.com
phone:
type: integer
description: Número de telefone do subordinado (opcional).
example: 5511999999999
password:
type: string
description: Senha do subordinado.
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 do subordinado (opcional).
example: 1990-01-01
responses:
201:
description: Subordinado criado com sucesso.
schema:
type: object
properties:
message:
type: string
example: Subordinado criado com sucesso.
subordinate_id:
type: integer
example: 42
400:
description: Erro na criação do subordinado.
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.