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

92 lines
2.4 KiB
YAML

tags:
- Camera
summary: Cria uma nova camera
security:
- bearerAuth: []
parameters:
- in: body
name: body
description: Dados para a criação de uma nova camera
required: true
schema:
type: object
properties:
name:
type: string
description: Nome da camera
example: "camera entrada"
description:
type: string
description: Descrição da localização ou modelo da camera
example: "camera entrada modelo xxx."
service_id:
type: integer
description: ID do serviço associado
example: 1
ambiente_id:
type: integer
description: ID do serviço associado
example: 1
service_role_id:
type: integer
description: ID do serviço associado
example: 14
responses:
201:
description: Camera cadastrada com sucesso
content:
application/json:
schema:
type: object
properties:
id:
type: integer
description: ID da nova camera
name:
type: string
description: Nome da camera
description:
type: string
description: Descrição da camera
service_id:
type: integer
description: ID do serviço associado
ambiente_id:
type: integer
description: ID do ambiente_id
service_role_id:
type: integer
description: ID do serviço role
examples:
application/json:
id: 1
name: "camera entrada"
description: "camera sony entrada."
service_id: 3
ambiente_id: 1
service_role_id: 5
400:
description: Requisição inválida (dados incorretos ou ausentes)
content:
application/json:
schema:
type: object
properties:
error:
type: string
examples:
application/json:
error: "Os campos 'name' e 'service_id' são obrigatórios."
401:
description: Token inválido ou ausente
content:
application/json:
schema:
type: object
properties:
error:
type: string
examples:
application/json:
error: "Token inválido ou ausente"