Pular para o conteúdo
API e webhooksv1
openapi.yaml
Menu da APICatálogo · Listar canais de venda

Listar canais de venda

GET https://api.precificador3d.com.br/v1/canais

Escopo: produtos:ler.

cURL

curl "https://api.precificador3d.com.br/v1/canais" \
  -H "Authorization: Bearer $PC3D_CHAVE"

JavaScript

const resposta = await fetch('https://api.precificador3d.com.br/v1/canais', {
  headers: {
    Authorization: `Bearer ${process.env.PC3D_CHAVE}`,
  },
});
if (!resposta.ok) {
  const erro = await resposta.json(); // application/problem+json
  throw new Error(`${erro.codigo}: ${erro.detail} (${erro.requisicao_id})`);
}
const dados = await resposta.json();

Python

import os

import requests

resposta = requests.get(
    "https://api.precificador3d.com.br/v1/canais",
    headers={
        "Authorization": f"Bearer {os.environ['PC3D_CHAVE']}",
    },
    timeout=10,
)
resposta.raise_for_status()
dados = resposta.json()

Cabeçalhos

If-None-Matchstring
ETag recebida antes. Se nada mudou, a resposta é 304 e não gasta a cota mensal. (até 100 caracteres)

Resposta 200

Canais da conta.

Campos da resposta (6)
dadosarray de Canal
(0 a 100 itens)
dados[].idstring (uuid)
dados[].nomestring
dados[].tipostring
Valores: loja, marketplace.
dados[].arredondamentostring
Valores: nenhum, cima_90, cima_inteiro.
dados[].ativoboolean
200 Resposta
{
  "dados": [
    {
      "id": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f",
      "nome": "Loja própria",
      "tipo": "loja",
      "arredondamento": "cima_90",
      "ativo": true
    },
    {
      "id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
      "nome": "Marketplace Exemplo",
      "tipo": "marketplace",
      "arredondamento": "cima_90",
      "ativo": true
    }
  ]
}

Outras respostas

  • 304 Nada mudou desde a ETag informada.
  • 401 nao_autenticado: Chave ausente, malformada, desconhecida, revogada ou expirada (a resposta é a mesma para todos os casos).
  • 403 escopo_insuficiente: Escopo insuficiente, conta bloqueada, módulo desligado ou chave suspensa.
  • 429 limite_excedido: Limite de uso excedido (rajada, minuto, mês ou requisições simultâneas).
  • 500 erro_interno: Erro interno. O detalhe fica no log, ligado ao requisicao_id.
  • 503 indisponivel: API desligada, sob pressão (disjuntor aberto) ou no limite global da plataforma.

Esta página em Markdown · llms.txt