Referência pública

API Tabela SIPE

Catálogo normalizado de eletrônicos: marca, modelo, armazenamento, memória, cor, processador e identificadores de fábrica. Respostas em JSON, autenticação por chave.

Autenticação

Toda chamada exige uma chave enviada no cabeçalho Authorization. A chave começa com sipe_live_ e nunca deve ser usada no navegador do usuário final.

curl "https://api.tabelasipe.com/v1/aparelhos?marca=Apple&modelo=iPhone 15" \
  -H "Authorization: Bearer sipe_live_sua_chave"

Limites de uso

Contas novas começam com 10 consultas gratuitas para teste. Depois disso a chave fica bloqueada até a contratação de um plano. Cada chamada bem sucedida consome uma consulta.

Consulta agrupada

GET /v1/aparelhos

Devolve uma linha por aparelho, com as opções resumidas em listas. Ideal para preencher seletores de armazenamento, memória e cor.

modelotexto · obrigatório

Nome ou parte do nome do aparelho.

marcatexto

Restringe a busca a uma marca. Recomendado para reduzir ambiguidade.

limitenúmero

Quantidade máxima de aparelhos na resposta.

{
  "count": 1,
  "data": [{
    "device_id": "3f1c8a52",
    "device": "Apple iPhone 15",
    "brand": "Apple",
    "category": "smartphone",
    "storage_options_gb": [128, 256, 512],
    "ram_options_gb": [6],
    "colors": ["Preto", "Azul", "Rosa"],
    "combinations_count": 9,
    "released_date": "2023-09-22",
    "image_url": "https://...",
    "brand_logo_url": "https://..."
  }]
}

Consulta detalhada

GET /v1/aparelhos/detalhado

Devolve uma linha por combinação de armazenamento, memória e cor. Os filtros são opcionais: sem informar o armazenamento, você recebe todas as capacidades.

modelotexto · obrigatório

Nome ou parte do nome do aparelho.

marcatexto

Restringe a busca a uma marca.

gbnúmero

Filtra por armazenamento. Omita para receber todas as capacidades.

ramnúmero

Filtra por memória.

cortexto

Filtra por cor de fábrica.

limitenúmero

Quantidade máxima de linhas na resposta.

{
  "count": 2,
  "data": [{
    "device_id": "3f1c8a52",
    "variant_id": "a91b0c77",
    "device": "Apple iPhone 15",
    "variant": "128GB · 6GB RAM · Preto",
    "storage_gb": 128,
    "ram_gb": 6,
    "color": "Preto",
    "cpu": "A16 Bionic",
    "model_number": "A3090",
    "released_date": "2023-09-22"
  }]
}

Erros

Erros seguem sempre o mesmo formato, com um código estável e uma mensagem legível.

{ "error": { "code": "missing_model", "message": "Informe o parâmetro modelo." } }
400 missing_modelrequisição

O parâmetro modelo não foi informado.

401 unauthorizedchave

Chave ausente, inválida ou revogada.

402 quota_exceededcota

As consultas gratuitas terminaram.

503 unavailableserviço

Consulta indisponível no momento. Tente novamente.