post
https://app.fracttal.com/api/tasks_types_catalog/
Cria um novo valor em um dos três catálogos auxiliares de Tarefas — Tipo de Tarefa, Classificação 1 ou Classificação 2 — de acordo com o subcatálogo indicado no parâmetro type. Atua como um único endpoint dispatcher que direciona a criação para a lógica já existente de cada subcatálogo.
Uso geral — sem add-on específico.
POST https://app.fracttal.com/api/tasks_types_catalogParâmetros de entrada
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
type | texto | Sim | Subcatálogo de destino. Valores válidos: TYPE_TASK (Tipo de Tarefa), GROUP_1 (Classificação 1), GROUP_2 (Classificação 2). |
description | texto | Sim | Valor a ser criado no subcatálogo indicado por type. Comprimento máximo: 200 caracteres para GROUP_1; 50 caracteres para TYPE_TASK e GROUP_2. |
Regras detypeedescription
- Valores válidos de
type:TYPE_TASK(Tipo de Tarefa),GROUP_1(Classificação 1),GROUP_2(Classificação 2). Qualquer outro valor retorna erro (ver Erros).- O limite de comprimento de
descriptiondepende do subcatálogo de destino: 200 caracteres paraGROUP_1, 50 caracteres paraTYPE_TASKeGROUP_2.- A validação de duplicidade é feita por subcatálogo: uma mesma
descriptionpode existir em valores diferentes detypesem ser considerada duplicada (por exemplo, "Corretivo" pode existir simultaneamente comoTYPE_TASKe comoGROUP_1).
Parâmetros de saída
| Parâmetro | Tipo | Descrição |
|---|---|---|
success | booleano | Indica se a operação foi bem-sucedida. |
message | texto | Mensagem descritiva do resultado. |
total | inteiro | Quantidade de registros afetados (1 em caso de criação bem-sucedida). |
data | objeto | Contém o registro criado. |
data.id | inteiro | Identificador único do novo registro. |
Erros
| Código | Causa |
|---|---|
400 | type ausente, vazio ou diferente de TYPE_TASK, GROUP_1 ou GROUP_2. |
400 | description ausente, vazia ou composta apenas por espaços. |
400 | description excede o comprimento máximo permitido para o subcatálogo indicado (200 para GROUP_1, 50 para TYPE_TASK/GROUP_2). |
401 | Token de autenticação inválido, expirado ou ausente. |
403 | A conta autenticada não tem permissão sobre o módulo de Configuração > Catálogos. |
404 | Já existe uma description igual (sem distinção entre maiúsculas/minúsculas) dentro do mesmo subcatálogo (type) para a empresa. |
500 | Erro interno não tratado. |
Nota sobre o código404Este endpoint usa
404para indicar que o valor já existe no subcatálogo, seguindo a convenção predominante de outros endpoints do mesmo módulo — não é um404padrão de "recurso não encontrado".
Exemplo
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 o comprimento máximo (400)
description excede o comprimento máximo (400){
"success": false,
"message": "description exceeds maximum length of 50 characters",
"total": 0,
"data": null
}Response — description duplicada no mesmo subcatálogo (404)
description duplicada no mesmo subcatá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
}