Criar planos de tarefas

post

https://app.fracttal.com/api/groups_tasks/

Crie um novo plano de tarefas enviando uma descrição e uma localização associada opcional.

Crie um novo plano de tarefas enviando a descrição do plano e, opcionalmente, uma localização associada.

Parâmetros de entrada (Body)

Envie os seguintes parâmetros no corpo da solicitação em formato JSON.

Parâmetro	Tipo	Obrigatório	Descrição
`description`	Texto	Sim	Descrição do plano de tarefas. Deve ter de 1 a 255 caracteres. Não pode estar vazia nem conter apenas espaços em branco.
`id_location`	Inteiro	Opcional	ID da localização no catálogo. Se omitido, o plano não fica restrito a uma localização. Se informado, deve corresponder a uma localização válida.

Parâmetros de saída

Parâmetro	Tipo	Descrição
`success`	Booleano	`true` se a operação foi bem-sucedida.
`message`	Texto	Código HTTP como string (`"201"`).
`data.id`	Inteiro	ID único gerado do plano de tarefas.
`data.description`	Texto	Descrição do plano criado.
`data.id_location`	Inteiro	ID da localização atribuída (`null` se não foi informado).
`data.task_number`	Inteiro	Quantidade de tarefas associadas ao plano, inicializada como `0`.
`data.assets_number`	Inteiro	Quantidade de ativos vinculados, inicializada como `0`.
`data.is_active`	Booleano	Status ativo do plano (`true` por padrão).
`total`	Texto	Total de registros criados (`"1"`).

Códigos de erro

Código	Condição
`400 Bad Request`	`description` vazia, nula, contendo apenas espaços em branco ou com mais de 255 caracteres; `id_location` não existe.
`401 Unauthorized`	Token Bearer ausente, expirado ou inválido.
`403 Forbidden`	Usuário sem a função `gestor de tarefas` ou superior.
`500 Internal Server Error`	Falha na criação no banco de dados.

Exemplo

Solicitação: POST https://app.fracttal.com/api/groups_tasks

{
  "description": "Manutenção preventiva das bombas do setor norte",
  "id_location": 1
}

Resposta:

{
  "success": true,
  "message": "201",
  "data": {
    "id": 385298,
    "description": "Manutenção preventiva das bombas do setor norte",
    "id_location": 1,
    "task_number": 0,
    "assets_number": 0,
    "is_active": true
  },
  "total": "1"
}

Resposta sem `id_location`

{
  "success": true,
  "message": "201",
  "data": {
    "id": 385299,
    "description": "Plano geral de inspeção",
    "id_location": null,
    "task_number": 0,
    "assets_number": 0,
    "is_active": true
  },
  "total": "1"
}

TESTAR CONEXÃO

Response

200

Language

Loading…