Crear planes de tareas

post

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

Mediante esta API puedes crear un nuevo plan de tareas.

Crea un nuevo plan de tareas enviando la descripción del plan y, opcionalmente, una localización asociada.

Parámetros de entrada (Body)

Los siguientes parámetros deben enviarse en el cuerpo de la solicitud en formato JSON.

Parámetro	Tipo	Requerido	Descripción
`description`	Texto	Sí	Descripción del plan de tareas. Longitud 1–255 caracteres. No puede estar vacío ni contener solo espacios en blanco.
`id_location`	Entero	Opcional	ID de localización del catálogo. Si se omite, el plan no queda restringido a localización. Si se proporciona, debe corresponder a una localización válida.

Parámetros de salida

Parámetro	Tipo	Descripción
`success`	Booleano	`true` si la operación fue exitosa.
`message`	Texto	Código HTTP como string (`"201"`).
`data.id`	Entero	ID único generado del plan de tareas.
`data.description`	Texto	Descripción del plan creado.
`data.id_location`	Entero	ID de localización asignada (`null` si no se proporcionó).
`data.task_number`	Entero	Cantidad de tareas asociadas al plan, inicializado en `0`.
`data.assets_number`	Entero	Cantidad de activos vinculados, inicializado en `0`.
`data.is_active`	Booleano	Estado activo del plan (`true` por defecto).
`total`	Texto	Total de registros creados (`"1"`).

Códigos de error

Código	Condición
`400 Bad Request`	`description` vacía, nula, solo espacios en blanco o mayor a 255 caracteres; `id_location` no existe.
`401 Unauthorized`	Token Bearer ausente, expirado o inválido.
`403 Forbidden`	Usuario sin rol `gestor de tareas` o superior.
`500 Internal Server Error`	Fallo en la creación en base de datos.

Ejemplo

Petición: POST https://app.fracttal.com/api/groups_tasks

{
  "description": "Mantenimiento preventivo bombas sector norte",
  "id_location": 1
}

Respuesta:

{
  "success": true,
  "message": "201",
  "data": {
    "id": 385298,
    "description": "Mantenimiento preventivo bombas sector norte",
    "id_location": 1,
    "task_number": 0,
    "assets_number": 0,
    "is_active": true
  },
  "total": "1"
}

Respuesta sin `id_location`

{
  "success": true,
  "message": "201",
  "data": {
    "id": 385299,
    "description": "Plan general de inspección",
    "id_location": null,
    "task_number": 0,
    "assets_number": 0,
    "is_active": true
  },
  "total": "1"
}

PROBAR CONEXION

Response

200

Language

Loading…