Documento técnico

Metodologia e arquitetura de dados

Catálogo próprio como fonte da verdade

Cada aparelho recebe um identificador Tabela SIPE único e estável. Os dados são consolidados e preservados integralmente na nossa base, garantindo consistência e disponibilidade em tempo de consulta.

Normalização canônica

Nomes, marcas e capacidades passam por normalização determinística: remoção de acentos, unificação de unidades (GB/TB) e separação entre modelo, armazenamento e memória. A consulta do usuário é interpretada pelo mesmo pipeline, garantindo simetria entre indexação e busca.

Apelidos comerciais

O mercado não usa o nome técnico. Para cada aparelho geramos variações previsíveis · com e sem marca, “+” e “Plus”, siglas e model numbers · o que permite reconhecer “S23 Plus 256” tanto quanto “Samsung Galaxy S23+ 256GB”.

Cobertura contínua

O catálogo é expandido de forma contínua: novos lançamentos, marcas e variantes entram na base assim que passam pelo pipeline de normalização, sem intervenção manual.

Atualização auditável

Toda atualização gera uma execução registrada, com contagens de criados, atualizados e erros, além de eventos detalhados. Falhas externas são tratadas com nova tentativa e não interrompem o catálogo existente.

Preparado para valuation e API

As estruturas de preço de lançamento, preço de mercado, ajustes por condição e versões de modelo já existem, assim como contas, chaves e consumo de crédito da futura API. Nesta etapa nenhuma estimativa de valor é publicada.

Contrato da API

Resposta completa de /v1/cotacao

Autenticação por chave no formato sipe_live_… (ou sipe_test_… em sandbox), enviada no cabeçalho Authorization como Bearer. Abaixo o payload integral entregue por consulta.

GET /v1/cotacao/iphone-15?armazenamento=128&condicao=bom
Authorization: Bearer sipe_live_9f21c...

{
  "device_id": "sipe_dev_9f21c",
  "device": "Apple iPhone 15 128GB",
  "marca": "Apple",
  "categoria": "smartphone",
  "modelo": "iPhone 15",
  "model_numbers": ["A3090", "A2846"],
  "apelidos": ["iphone 15", "iphone 15 128gb", "ip15"],
  "armazenamento_gb": 128,
  "memoria_gb": 6,
  "lancamento": "2023-09-22",
  "preco_lancamento": { "valor": 7299.00, "moeda": "BRL" },
  "condicao": "bom",
  "preco_medio_brl": 3742.90,
  "faixa": { "min": 3390.00, "max": 4120.00 },
  "por_condicao": {
    "excelente": 4120.00,
    "bom": 3742.90,
    "regular": 3280.00,
    "com_defeito": 2190.00
  },
  "tendencia_90d_pct": -6.4,
  "amostras": 184,
  "confianca": 0.92,
  
  "atualizado_em": "2026-08-29T23:10:00Z"
}

Os campos de preço passam a ser preenchidos quando o módulo de valuation entra em operação. Nesta etapa a API entrega identificação, normalização e ficha técnica.