Consultar tarefas

Por meio desta API você pode consultar a lista de tarefas criadas na sua empresa. Serão listadas tanto as tarefas que pertencem a um plano de tarefas quanto as tarefas não planejadas.

Parâmetros de entrada

Os seguintes parâmetros de entrada são opcionais e servem para paginar a consulta.
Por padrão, a API Fracttal retorna apenas 100 registros.

ParâmetroTipoObrigatórioDescrição
id_group_taskInteiroOpcionalNúmero do plano de tarefas
startInteiroOpcionalNúmero do registro inicial que a consulta exibirá.
limitInteiroOpcionalNúmero do registro final que a consulta retornará.
📘

Esta API aceita filtros dinâmicos

Além de id_group_task, start e limit, você pode filtrar por qualquer campo da tarefa usando a notação campo[operador]=valor (por exemplo description[like]=manutenção ou is_active[eq]=true). O parâmetro id_group_task continua funcionando como antes e pode ser combinado com os novos filtros. Consulte os operadores disponíveis e exemplos de uso em Filtros dinâmicos.

Parâmetros de saída

ParâmetroTipoDescrição
id_group_taskInteiroId do plano de tarefas ao qual pertence. Null se for uma tarefa não planejada
durationInteiroDuração da tarefa em segundos
descriptionTextoDescrição da tarefa
is_activeBooleanoIndica se a tarefa existe. Sempre retorna true. Não reflete se a tarefa está pausada dentro do seu plano; para isso, consulte is_plan_active.
is_plan_activeBooleanoIndica se a tarefa está ativa ou pausada dentro do seu plano. true = a tarefa está ativa. false = a tarefa foi pausada dentro do plano.
stop_assetsBooleanoTrue se o ativo está parado, false caso contrário
stop_assets_secInteiroTempo de parada do ativo em segundos
priorities_descriptionTextoDescrição da prioridade
groups_tasks_descriptionTextoDescrição do plano de tarefas
tasks_types_descriptionTextoClassificação 1 da tarefa
tasks_types_main_descriptionTextoTipo de tarefa
noteTextoNota da tarefa
requested_byTextoSolicitado por
id_requestInteiroId da solicitação
num_iterationsInteiroNúmero de iterações
is_cyclicalBooleanoSe é uma tarefa cíclica
name_iterationsJSONConteúdo das iterações das tarefas cíclicas
📘

Como saber se uma tarefa está pausada

Para saber se uma tarefa está pausada, consulte is_plan_active. is_active não muda ao pausar ou retomar uma tarefa.

Exemplo:

Requisição: (GET)https://app.fracttal.com/api/tasks/

{
  "success": true,
  "message": "200",
  "data": [
    {
      "id": 255,
      "id_company": 914,
      "id_group_task": 2,
      "id_priorities": 3,
      "id_task_type_main": 14,
      "id_task_type": null,
      "id_task_type_2": null,
      "duration": 600,
      "description": "60 PUNTOS",
      "is_active": true,
      "is_plan_active": true,
      "stop_assets": false,
      "stop_assets_sec": null,
      "tasks_types_2_description": null,
      "priorities_description": "MEDIUM",
      "groups_tasks_description": "PLAN DE MANTENIMIENTO CAMIÓN FREIGHTLINER M102",
      "tasks_types_description": null,
      "tasks_types_main_description": "INSPECCIÓN",
      "tasks_types_main_color": null,
      "note": null,
      "requested_by": null,
      "id_request": null,
      "is_configured": true,
      "event_date": null,
      "num_iterations": null,
      "is_cyclical": null,
      "name_iterations": {}
    },
    {
      "id": 1676537,
      "id_company": 914,
      "id_group_task": 45623,
      "id_priorities": 3,
      "id_task_type_main": 14,
      "id_task_type": null,
      "id_task_type_2": null,
      "duration": 600,
      "description": "60 PUNTOS",
      "is_active": true,
      "is_plan_active": true,
      "stop_assets": false,
      "stop_assets_sec": null,
      "tasks_types_2_description": null,
      "priorities_description": "MEDIUM",
      "groups_tasks_description": "PLAN DE MANTENIMIENTO CAMIÓN MIXER",
      "tasks_types_description": null,
      "tasks_types_main_description": "INSPECCIÓN",
      "tasks_types_main_color": null,
      "note": null,
      "requested_by": null,
      "id_request": null,
      "is_configured": true,
      "event_date": null,
      "num_iterations": null,
      "is_cyclical": null,
      "name_iterations": {}
    },
    {
      "id": 1424185,
      "id_company": 914,
      "id_group_task": 39840,
      "id_priorities": 3,
      "id_task_type_main": 14,
      "id_task_type": null,
      "id_task_type_2": null,
      "duration": 600,
      "description": "60 PUNTOS",
      "is_active": true,
      "is_plan_active": false,
      "stop_assets": false,
      "stop_assets_sec": null,
      "tasks_types_2_description": null,
      "priorities_description": "MEDIUM",
      "groups_tasks_description": "PLAN DE MANTENIMIENTO CAMIÓN MIXER",
      "tasks_types_description": null,
      "tasks_types_main_description": "INSPECCIÓN",
      "tasks_types_main_color": null,
      "note": null,
      "requested_by": null,
      "id_request": null,
      "is_configured": true,
      "event_date": null,
      "num_iterations": null,
      "is_cyclical": null,
      "name_iterations": {}
    },
    {
      "id": 3363315,
      "id_company": 914,
      "id_group_task": 87029,
      "id_priorities": 3,
      "id_task_type_main": 14,
      "id_task_type": null,
      "id_task_type_2": null,
      "duration": 600,
      "description": "60 PUNTOS",
      "is_active": true,
      "is_plan_active": true,
      "stop_assets": false,
      "stop_assets_sec": null,
      "tasks_types_2_description": null,
      "priorities_description": "MEDIUM",
      "groups_tasks_description": "PLAN DE MANTENIMIENTO BUS",
      "tasks_types_description": null,
      "tasks_types_main_description": "INSPECCIÓN",
      "tasks_types_main_color": null,
      "note": null,
      "requested_by": null,
      "id_request": null,
      "is_configured": true,
      "event_date": null,
      "num_iterations": null,
      "is_cyclical": null,
      "name_iterations": {}
    },
    {
      "id": 336,
      "id_company": 914,
      "id_group_task": null,
      "id_priorities": 3,
      "id_task_type_main": 14,
      "id_task_type": 24,
      "id_task_type_2": null,
      "duration": 600,
      "description": "60 PUNTOS ( Tarea No Planificada )",
      "is_active": true,
      "is_plan_active": true,
      "stop_assets": false,
      "stop_assets_sec": null,
      "tasks_types_2_description": null,
      "priorities_description": "MEDIUM",
      "groups_tasks_description": null,
      "tasks_types_description": "PROYECTO 02",
      "tasks_types_main_description": "INSPECCIÓN",
      "tasks_types_main_color": null,
      "note": "",
      "requested_by": "miguel",
      "id_request": null,
      "is_configured": true,
      "event_date": "2020-07-20T20:30:00+00:00",
      "num_iterations": null,
      "is_cyclical": null,
      "name_iterations": null
    }
  ],
  "total": 5
}

OpenAPI definition

{
  "openapi": "3.1.0",
  "info": {
    "title": "consultar-tareas",
    "version": "3-pt"
  },
  "servers": [
    {
      "url": "https://app.fracttal.com/api/tasks/"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/": {
      "get": {
        "summary": "Consultar tarefas",
        "description": "",
        "operationId": "consultar-tareas",
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
Response
200
Language
LoadingLoading…