Centros de Custos Categorias

Visão Geral

O módulo Centros de Custos Categorias gerencia as categorias que organizam os centros de custo em uma hierarquia. Cada categoria pode ter um nível, ordem, responsável e pode ser vinculada a uma categoria pai.

Base URL

/api/centros-custos-categorias

Todos os endpoints requerem autenticação via Bearer Token:
Authorization: Bearer {token}

Endpoints

GET /api/centros-custos-categorias

Descrição: Retorna a lista completa de categorias de centros de custo, incluindo hierarquia e responsáveis.

Parâmetros

Nenhum parâmetro de query.

Resposta de Sucesso `200`

[
  {
    "id": "1",
    "nome": "Operacional",
    "ordem": 1,
    "nivel": 1,
    "codigo": "OP",
    "responsavel": "João Silva",
    "telefone": "(11) 99999-0001",
    "email": "[email protected]",
    "centroCustoCategoriaId": null,
    "centroCustoCategoriaNome": null,
    "tipo": 1
  }
]

Campos da Resposta

Campo	Tipo	Descrição
`id`	string	Identificador único da categoria
`nome`	string	Nome da categoria
`ordem`	integer	Ordem de exibição
`nivel`	integer	Nível hierárquico da categoria
`codigo`	string	Código identificador da categoria
`responsavel`	string	Nome do responsável
`telefone`	string	Telefone de contato
`email`	string	E-mail de contato
`centroCustoCategoriaId`	integer (int64)	ID da categoria pai (hierarquia)
`centroCustoCategoriaNome`	string	Nome da categoria pai
`tipo`	integer	Tipo da categoria (1 = Receita, 2 = Despesa)

Códigos de Erro

Código	Descrição
`401`	Token ausente ou inválido
`500`	Erro interno do servidor

Exemplos de Código

cURL

curl -X GET "https://api.app.hooked.com.br/api/centros-custos-categorias" \
  -H "Authorization: Bearer {token}"

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/centros-custos-categorias', {
  headers: { 'Authorization': 'Bearer {token}' }
});
const data = await response.json();

Python

import requests

data = requests.get(
    'https://api.app.hooked.com.br/api/centros-custos-categorias',
    headers={'Authorization': 'Bearer {token}'}
).json()

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/centros-custos-categorias", nil)
req.Header.Set("Authorization", "Bearer {token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/centros-custos-categorias');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — GET /api/centros-custos-categorias",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/centros-custos-categorias",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

POST /api/centros-custos-categorias

Descrição: Cria uma nova categoria de centro de custo.

Corpo da Requisição

{
  "nome": "Operacional",
  "tipo": 1
}

Campo	Tipo	Obrigatório	Regras	Descrição
`nome`	string	✓	mín. 1 caractere	Nome da categoria
`tipo`	integer	—	—	Tipo da categoria (1 = Receita, 2 = Despesa)

Resposta de Sucesso `200`

{
  "id": 5,
  "nome": "Operacional",
  "tipo": 1
}

Códigos de Erro

Código	Descrição
`400`	Dados inválidos — nome ausente ou vazio
`401`	Token ausente ou inválido
`500`	Erro interno do servidor

Exemplos de Código

cURL

curl -X POST "https://api.app.hooked.com.br/api/centros-custos-categorias" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"nome":"Operacional","tipo":1}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/centros-custos-categorias', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "nome": "Operacional",
  "tipo": 1
})
});
const data = await response.json();

Python

import requests

data = requests.post(
    'https://api.app.hooked.com.br/api/centros-custos-categorias',
    headers={'Authorization': 'Bearer {token}'},
    json={'nome': 'Operacional', 'tipo': 1}
).json()

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"nome":"Operacional","tipo":1}`)
req, _ := http.NewRequest("POST", "https://api.app.hooked.com.br/api/centros-custos-categorias", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer {token}")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/centros-custos-categorias');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'nome' => 'Operacional',
        'tipo' => 1
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — POST /api/centros-custos-categorias",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.app.hooked.com.br/api/centros-custos-categorias",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"nome\":\"Operacional\",\"tipo\":1}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

GET /api/centros-custos-categorias/{id}

Descrição: Retorna os dados de uma categoria específica pelo ID.

Parâmetros

Nome	Tipo	Local	Obrigatório	Descrição
`id`	integer (int64)	path	✓	ID da categoria

Resposta de Sucesso `200`

{
  "id": 1,
  "nome": "Operacional",
  "tipo": 1
}

Códigos de Erro

Código	Descrição
`401`	Token ausente ou inválido
`404`	Categoria não encontrada
`500`	Erro interno do servidor

Exemplos de Código

cURL

curl -X GET "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}" \
  -H "Authorization: Bearer {token}"

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/centros-custos-categorias/{id}', {
  headers: { 'Authorization': 'Bearer {token}' }
});
const data = await response.json();

Python

import requests

data = requests.get(
    'https://api.app.hooked.com.br/api/centros-custos-categorias/{id}',
    headers={'Authorization': 'Bearer {token}'}
).json()

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}", nil)
req.Header.Set("Authorization", "Bearer {token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/centros-custos-categorias/{id}');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — GET /api/centros-custos-categorias/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

PUT /api/centros-custos-categorias/{id}

Descrição: Atualiza os dados de uma categoria existente.

Parâmetros

Nome	Tipo	Local	Obrigatório	Descrição
`id`	integer (int64)	path	✓	ID da categoria a ser atualizada

Corpo da Requisição

{
  "id": 1,
  "nome": "Operacional Atualizado",
  "tipo": 2
}

Resposta de Sucesso `200`

Retorna o objeto atualizado com a mesma estrutura do POST.

Códigos de Erro

Código	Descrição
`400`	Dados inválidos
`401`	Token ausente ou inválido
`404`	Categoria não encontrada
`500`	Erro interno do servidor

Exemplos de Código

cURL

curl -X PUT "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"id":1,"nome":"Operacional Atualizado","tipo":2}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/centros-custos-categorias/{id}', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "id": 1,
  "nome": "Operacional Atualizado",
  "tipo": 2
})
});
const data = await response.json();

Python

import requests

data = requests.put(
    'https://api.app.hooked.com.br/api/centros-custos-categorias/{id}',
    headers={'Authorization': 'Bearer {token}'},
    json={'id': 1, 'nome': 'Operacional Atualizado', 'tipo': 2}
).json()

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"id":1,"nome":"Operacional Atualizado","tipo":2}`)
req, _ := http.NewRequest("PUT", "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer {token}")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/centros-custos-categorias/{id}');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'id' => 1,
        'nome' => 'Operacional Atualizado',
        'tipo' => 2
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — PUT /api/centros-custos-categorias/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "PUT",
        "url": "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"id\":1,\"nome\":\"Operacional Atualizado\",\"tipo\":2}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

DELETE /api/centros-custos-categorias/{id}

Descrição: Remove uma categoria de centro de custo pelo ID.

Parâmetros

Nome	Tipo	Local	Obrigatório	Descrição
`id`	integer (int64)	path	✓	ID da categoria a ser removida

Resposta de Sucesso `200`

Retorna o objeto removido com a mesma estrutura do GET /{id}.

Códigos de Erro

Código	Descrição
`401`	Token ausente ou inválido
`404`	Categoria não encontrada
`500`	Erro interno do servidor

Exemplos de Código

cURL

curl -X DELETE "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}" \
  -H "Authorization: Bearer {token}"

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/centros-custos-categorias/{id}', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer {token}' }
});
const data = await response.json();

Python

import requests

data = requests.delete(
    'https://api.app.hooked.com.br/api/centros-custos-categorias/{id}',
    headers={'Authorization': 'Bearer {token}'}
).json()

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("DELETE", "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}", nil)
req.Header.Set("Authorization", "Bearer {token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/centros-custos-categorias/{id}');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — DELETE /api/centros-custos-categorias/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "DELETE",
        "url": "https://api.app.hooked.com.br/api/centros-custos-categorias/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

Visão Geral

Base URL

Endpoints

Parâmetros

Resposta de Sucesso 200

Campos da Resposta

Códigos de Erro

Exemplos de Código

Corpo da Requisição

Resposta de Sucesso 200

Códigos de Erro

Exemplos de Código

Parâmetros

Resposta de Sucesso 200

Códigos de Erro

Exemplos de Código

Parâmetros

Corpo da Requisição

Resposta de Sucesso 200

Códigos de Erro

Exemplos de Código

Parâmetros

Resposta de Sucesso 200

Códigos de Erro

Exemplos de Código

Resposta de Sucesso `200`

Resposta de Sucesso `200`

Resposta de Sucesso `200`

Resposta de Sucesso `200`

Resposta de Sucesso `200`