BrindesBrasil.com.br

Busca brindes no catálogo por texto (nome, tipo, material) ou SKU. Devolve título, SKU, link, imagem, preço unitário a partir de (com gravação), situação de estoque (em_estoque, estoque_baixo, sob_encomenda, sem_estoque), estoque_qtd e primeira_faixa (primeira quantidade da tabela de preço, NÃO é pedido mínimo).

{
  "type": "object",
  "properties": {
    "busca": {
      "type": "string",
      "description": "O que procurar. Ex.: \"garrafa inox\", \"caneta metal touch\", \"SPX-08103\"."
    },
    "categoria": {
      "type": "string",
      "description": "Opcional: slug de categoria vindo de listar_categorias."
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 8
    }
  },
  "required": [
    "busca"
  ]
}

Detalhes de um produto: descrição, cores do mesmo modelo, estoque, medidas da caixa, técnicas de gravação disponíveis e tabela de preço por quantidade (preço unitário com 1 gravação).

{
  "type": "object",
  "properties": {
    "produto": {
      "type": "string",
      "description": "SKU do produto (ex.: SPX-10338-BCO) ou ID numérico."
    }
  },
  "required": [
    "produto"
  ]
}

Calcula preço unitário e total de um produto para uma quantidade e número de gravações (aplicações), com o mesmo motor do site. Não inclui frete.

{
  "type": "object",
  "properties": {
    "produto": {
      "type": "string",
      "description": "SKU do produto (ex.: SPX-10338-BCO) ou ID numérico."
    },
    "quantidade": {
      "type": "integer",
      "minimum": 1,
      "description": "Quantidade de peças."
    },
    "aplicacoes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "default": 1,
      "description": "Número de gravações (0 = sem gravação, 1 a 4)."
    }
  },
  "required": [
    "produto",
    "quantidade"
  ]
}

Outras cores do mesmo modelo e produtos parecidos, na mesma ordem que a página do produto mostra.

{
  "type": "object",
  "properties": {
    "produto": {
      "type": "string",
      "description": "SKU do produto (ex.: SPX-10338-BCO) ou ID numérico."
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "default": 8
    }
  },
  "required": [
    "produto"
  ]
}

Descobre o SKU a partir de uma foto (URL https de brindesbrasil.com.br, ex.: o anexo do chat). Primeiro tenta pelo NOME do arquivo (imagem baixada do nosso site), depois compara com o índice de imagens do catálogo (distancia_hamming <= 10 = mesma forma; distancia_cor alta = mesmo modelo em outra cor; 11 a 16 = provável; acima disso não casa). Também lê o SKU gravado nos metadados do arquivo original. Se nada casar, devolve lista vazia: busque por texto.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL https da imagem (brindesbrasil.com.br)."
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5
    },
    "nome": {
      "type": "string",
      "description": "Opcional: nome original do arquivo (ex. Caneca-Inox-400ml-26931-1768333656.webp). Se vier de uma imagem do nosso site, acha o produto só pelo nome."
    },
    "candidatos": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "description": "Opcional: SKUs ou ids dos produtos que o cliente visitou (o radar.js lista). Compara primeiro só com eles; se não casar, usa o catálogo inteiro. `caminho` na resposta diz qual usou."
    }
  },
  "required": [
    "url"
  ]
}

Lista as categorias principais do catálogo com slug, link, quantidade de produtos e subcategorias.

{
  "type": "object",
  "properties": {}
}

Calcula o frete de um pedido para um CEP brasileiro com o mesmo cálculo do carrinho da loja (preço com gravação, produtos agrupados nas mesmas caixas quando cabem e somente as formas de envio habilitadas). Aceita um produto (produto + quantidade) ou vários em "itens" (até 10); o frete de vários produtos é o do pedido inteiro, que difere da soma de cotações separadas. Devolve cada opção com valor e prazo total (produção + entrega).

{
  "type": "object",
  "properties": {
    "cep": {
      "type": "string",
      "description": "CEP de destino no Brasil, 8 dígitos (ex.: 01310-100)."
    },
    "itens": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "description": "Produtos do pedido. Use para cotar vários produtos juntos.",
      "items": {
        "type": "object",
        "properties": {
          "produto": {
            "type": "string",
            "description": "SKU do produto (ex.: SPX-10338-BCO) ou ID numérico."
          },
          "quantidade": {
            "type": "integer",
            "minimum": 1
          },
          "aplicacoes": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4,
            "default": 1,
            "description": "Número de gravações (0 = sem gravação)."
          },
          "tecnica": {
            "type": "string",
            "description": "Opcional: técnica de gravação (ex.: \"Laser\"). Sem ela, a mais barata para a quantidade."
          }
        },
        "required": [
          "produto",
          "quantidade"
        ]
      }
    },
    "produto": {
      "type": "string",
      "description": "Para um produto só (alternativa a \"itens\"): SKU ou ID."
    },
    "quantidade": {
      "type": "integer",
      "minimum": 1,
      "description": "Para um produto só: quantidade de peças."
    },
    "aplicacoes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "default": 1,
      "description": "Para um produto só: número de gravações (0 = sem gravação)."
    },
    "tecnica": {
      "type": "string",
      "description": "Para um produto só: técnica de gravação (opcional)."
    }
  },
  "required": [
    "cep"
  ]
}