Preços · API Hooked

Visão Geral

O módulo Preços gerencia o cadastro de preços associados a produtos e serviços no sistema. Permite criar, consultar e atualizar registros de preços que podem ser vinculados a tabelas de preço e variações de produtos.

Endpoints

GET /api/precos

Descrição: Lista todos os preços cadastrados com suporte a filtros e paginação. Autenticação: Obrigatória

Parâmetros de Query

Parâmetro	Tipo	Obrigatório	Descrição
pagina	integer	Não	Número da página (padrão: 1)
quantidade	integer	Não	Itens por página (padrão: 20)
produtoServicoId	string	Não	Filtrar por produto/serviço
tabelaPrecoId	string	Não	Filtrar por tabela de preço

Resposta de Sucesso

{
  "dados": [
    {
      "id": "uuid",
      "produtoServicoId": "uuid",
      "produtoServicoNome": "Produto A",
      "tabelaPrecoId": "uuid",
      "tabelaPrecoNome": "Tabela Padrão",
      "preco": 99.90,
      "precoMinimo": 80.00,
      "precoMaximo": 120.00
    }
  ],
  "total": 50,
  "pagina": 1,
  "quantidade": 20
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
500	Erro interno do servidor

Exemplos de Código

cURL

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

JavaScript

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

Python

import requests

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

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/precos", 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/precos');
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/precos",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/precos",
        "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/precos

Descrição: Cria um novo plano/registro de preço (utilizado nas páginas públicas de planos da aplicação). Autenticação: Obrigatória

Corpo da Requisição (Request Body)

{
  "title": "Plano Profissional",
  "subtitle": "Para empresas em crescimento",
  "monthlyPrice": 199.90,
  "yearlyPlanMonthly": 179.90,
  "yearlyPlanAnnually": 2158.80,
  "currentPlan": false,
  "popularPlan": true,
  "imgSrc": "/img/planos/profissional.png",
  "imgHeight": 120,
  "imgWidth": 120,
  "planBenefits": "Suporte 24/7;Usuários ilimitados;Backup diário",
  "ordem": 2,
  "menus": []
}

Campo	Tipo	Obrigatório	Regras	Descrição
`title`	string	✓	mín. 1 caractere	Título do plano
`subtitle`	string	✓	mín. 1 caractere	Subtítulo/chamada do plano
`monthlyPrice`	number (double)	✓	—	Preço mensal do plano
`imgSrc`	string	✓	mín. 1 caractere	Caminho/URL da imagem do plano
`ordem`	integer (int32)	✓	—	Ordem de exibição do plano
`currentPlan`	boolean	—	—	Indica se é o plano atual do usuário
`popularPlan`	boolean	—	—	Indica se o plano é exibido como "popular"
`imgHeight`	integer (int32)	—	—	Altura da imagem (em pixels)
`imgWidth`	integer (int32)	—	—	Largura da imagem (em pixels)
`yearlyPlanMonthly`	number (double)	—	—	Preço mensal equivalente do plano anual
`yearlyPlanAnnually`	number (double)	—	—	Preço total do plano anual
`planBenefits`	string	—	—	Benefícios do plano (separados por `;`)
`menus`	array	—	—	Lista de menus/funcionalidades vinculados ao plano

Resposta de Sucesso

{
  "id": 1,
  "title": "Plano Profissional",
  "subtitle": "Para empresas em crescimento",
  "monthlyPrice": 199.90,
  "imgSrc": "/img/planos/profissional.png",
  "ordem": 2
}

Códigos de Erro Comuns

Código	Descrição
400	Dados inválidos
401	Não autorizado

Exemplos de Código

cURL

curl -X POST "https://api.app.hooked.com.br/api/precos" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"produtoServicoId":"uuid","tabelaPrecoId":"uuid","preco":99.9,"precoMinimo":80.0,"precoMaximo":120.0}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/precos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "produtoServicoId": "uuid",
  "tabelaPrecoId": "uuid",
  "preco": 99.9,
  "precoMinimo": 80.0,
  "precoMaximo": 120.0
})
});
const data = await response.json();

Python

import requests

data = requests.post(
    'https://api.app.hooked.com.br/api/precos',
    headers={'Authorization': 'Bearer {token}'},
    json={'produtoServicoId': 'uuid', 'tabelaPrecoId': 'uuid', 'preco': 99.9, 'precoMinimo': 80.0, 'precoMaximo': 120.0}
).json()

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"produtoServicoId":"uuid","tabelaPrecoId":"uuid","preco":99.9,"precoMinimo":80.0,"precoMaximo":120.0}`)
req, _ := http.NewRequest("POST", "https://api.app.hooked.com.br/api/precos", 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/precos');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'produtoServicoId' => 'uuid',
        'tabelaPrecoId' => 'uuid',
        'preco' => 99.9,
        'precoMinimo' => 80.0,
        'precoMaximo' => 120.0
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — POST /api/precos",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.app.hooked.com.br/api/precos",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"produtoServicoId\":\"uuid\",\"tabelaPrecoId\":\"uuid\",\"preco\":99.9,\"precoMinimo\":80.0,\"precoMaximo\":120.0}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

GET /api/precos/{id}

Descrição: Retorna os detalhes de um preço pelo seu identificador único. Autenticação: Obrigatória

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
id	string (uuid)	Sim	Identificador único do preço

Resposta de Sucesso

{
  "id": "uuid",
  "produtoServicoId": "uuid",
  "produtoServicoNome": "Produto A",
  "tabelaPrecoId": "uuid",
  "tabelaPrecoNome": "Tabela Padrão",
  "preco": 99.90,
  "precoMinimo": 80.00,
  "precoMaximo": 120.00
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
404	Preço não encontrado

Exemplos de Código

cURL

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

JavaScript

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

Python

import requests

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

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/precos/{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/precos/{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/precos/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/precos/{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/precos/{id}

Descrição: Atualiza um registro de preço existente. Autenticação: Obrigatória

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
id	string (uuid)	Sim	Identificador único do preço

Corpo da Requisição (Request Body)

{
  "preco": 109.90,
  "precoMinimo": 90.00,
  "precoMaximo": 130.00
}

Resposta de Sucesso

{
  "id": "uuid",
  "preco": 109.90,
  "precoMinimo": 90.00,
  "precoMaximo": 130.00
}

Códigos de Erro Comuns

Código	Descrição
400	Dados inválidos
401	Não autorizado
404	Preço não encontrado

Exemplos de Código

cURL

curl -X PUT "https://api.app.hooked.com.br/api/precos/{id}" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"preco":109.9,"precoMinimo":90.0,"precoMaximo":130.0}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/precos/{id}', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "preco": 109.9,
  "precoMinimo": 90.0,
  "precoMaximo": 130.0
})
});
const data = await response.json();

Python

import requests

data = requests.put(
    'https://api.app.hooked.com.br/api/precos/{id}',
    headers={'Authorization': 'Bearer {token}'},
    json={'preco': 109.9, 'precoMinimo': 90.0, 'precoMaximo': 130.0}
).json()

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"preco":109.9,"precoMinimo":90.0,"precoMaximo":130.0}`)
req, _ := http.NewRequest("PUT", "https://api.app.hooked.com.br/api/precos/{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/precos/{id}');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'preco' => 109.9,
        'precoMinimo' => 90.0,
        'precoMaximo' => 130.0
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — PUT /api/precos/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "PUT",
        "url": "https://api.app.hooked.com.br/api/precos/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"preco\":109.9,\"precoMinimo\":90.0,\"precoMaximo\":130.0}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}