post
https://app.fracttal.com/api/tasks_types_catalog/
Crea un nuevo valor en alguno de los tres catálogos auxiliares de Tareas — Tipo de Tarea, Clasificación 1 o Clasificación 2 — según el sub-catálogo indicado en el parámetro type. Actúa como un único endpoint dispatcher que enruta la creación hacia la lógica ya existente de cada sub-catálogo.
Uso general — sin add-on específico.
POST https://app.fracttal.com/api/tasks_types_catalogParámetros de entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
type | texto | Sí | Sub-catálogo destino. Valores válidos: TYPE_TASK (Tipo de Tarea), GROUP_1 (Clasificación 1), GROUP_2 (Clasificación 2). |
description | texto | Sí | Valor a crear en el sub-catálogo indicado por type. Longitud máxima: 200 caracteres para GROUP_1; 50 caracteres para TYPE_TASK y GROUP_2. |
Reglas detypeydescription
- Valores válidos de
type:TYPE_TASK(Tipo de Tarea),GROUP_1(Clasificación 1),GROUP_2(Clasificación 2). Cualquier otro valor retorna error (ver Errores).- El límite de longitud de
descriptiondepende del sub-catálogo destino: 200 caracteres paraGROUP_1, 50 caracteres paraTYPE_TASKyGROUP_2.- La validación de duplicados es por sub-catálogo: una misma
descriptionpuede existir en distintos valores detypesin ser considerada duplicada (por ejemplo, "Correctivo" puede existir simultáneamente comoTYPE_TASKy comoGROUP_1).
Parámetros de salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | booleano | Indica si la operación fue exitosa. |
message | texto | Mensaje descriptivo del resultado. |
total | entero | Cantidad de registros afectados (1 en creación exitosa). |
data | objeto | Contiene el registro creado. |
data.id | entero | Identificador único del nuevo registro. |
Errores
| Código | Causa |
|---|---|
400 | type ausente, vacío o distinto de TYPE_TASK, GROUP_1 o GROUP_2. |
400 | description ausente, vacía o compuesta solo por espacios. |
400 | description excede el largo máximo permitido para el sub-catálogo indicado (200 para GROUP_1, 50 para TYPE_TASK/GROUP_2). |
401 | Token de autenticación inválido, expirado o ausente. |
403 | La cuenta autenticada no tiene permiso sobre el módulo de Configuración > Catálogos. |
404 | Ya existe una description igual (sin distinción de mayúsculas/minúsculas) dentro del mismo sub-catálogo (type) para la empresa. |
500 | Error interno no controlado. |
Nota sobre el código404Este endpoint usa
404para indicar que el valor ya existe en el sub-catálogo, siguiendo la convención dominante de otros endpoints del mismo módulo — no es un404estándar de "recurso no encontrado".
Ejemplo
Request body
{
"type": "TYPE_TASK",
"description": "Preventivo"
}Response 200
200{
"success": true,
"message": "Registro creado exitosamente",
"total": 1,
"data": {
"id": 145
}
}Response — type inválido (400)
type inválido (400){
"success": false,
"message": "type no es válido. Valores permitidos: TYPE_TASK, GROUP_1, GROUP_2",
"total": 0,
"data": null
}Response — description excede el largo máximo (400)
description excede el largo máximo (400){
"success": false,
"message": "description exceeds maximum length of 50 characters",
"total": 0,
"data": null
}Response — description duplicada en el mismo sub-catálogo (404)
description duplicada en el mismo sub-catálogo (404){
"success": false,
"message": "404",
"total": 0,
"data": null
}OpenAPI definition
{
"openapi": "3.1.0",
"info": {
"title": "tareas",
"version": "1-Es"
},
"servers": [
{ "url": "https://app.fracttal.com/api/tasks_types_catalog" }
],
"security": [{}],
"paths": {
"/": {
"post": {
"summary": "Crear un valor en catálogos auxiliares de tareas (tipo, clasificación 1 y 2)",
"description": "",
"operationId": "crear-un-valor-en-catalogos-auxiliares-de-tareas",
"deprecated": false,
"security": []
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}