O que está no catálogo

Estes números são lidos diretamente da base de dados e atualizam-se sozinhos — não são valores escritos na página.

430.386: referências no total
59.862: nas coleções atuais
305: marcas
82.796: modelos
275.253: referências com fotografias
324.546: referências de lentes de contacto

O catálogo guarda também os modelos descontinuados: servem para identificar existências e coleções anteriores. Cada referência tem o seu próprio estado.

Como obter os dados

Dois caminhos para equipas diferentes: uma chamada a partir do seu sistema ou um ficheiro que qualquer pessoa abre.

API REST

Para integrar o site, o sistema de inventário ou os anúncios nos marketplaces.

Filtros por marca, modelo, tipo, género, forma, material e dezenas de outros campos
Paginação por cursor: o catálogo inteiro é descarregado sem falhas nem duplicados
Fluxo incremental: recolhe apenas o que mudou desde a última sincronização

Exportação Excel

Para quem precisa de um ficheiro e não de uma integração. Sem programador.

Escolha marcas, filtros e colunas e guarde a seleção como modelo
Antes de iniciar vê quantas referências entrarão no ficheiro
As exportações grandes são preparadas em segundo plano; a ligação aparece na sua conta

Fotografias

Imagens de produto em fundo limpo, prontas para a montra ou o marketplace.

Na API: ligações diretas para as imagens em cada referência
Nas exportações: um arquivo separado, organizado por marca e modelo
Dentro do arquivo há um índice que liga cada código de barras aos seus ficheiros

Que aspeto tem uma resposta

Dados reais do catálogo, não um exemplo da documentação.

Pedido

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

Resposta

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

O conjunto de campos é definido por si: se precisar apenas do código de barras, do preço e da ligação à fotografia, a resposta terá exatamente isso. A lista completa de campos é devolvida por /v1/meta — o ponto de partida mais prático para construir a integração.

Perguntas frequentes

O catálogo inclui existências?

Não. O catálogo são dados de referência: atributos, fotografias, códigos de barras e preços recomendados. A disponibilidade vive noutro sistema e não faz parte destes dados. Dizemo-lo à partida para não criar expectativas erradas.

Que preços fornecem?

Os preços de venda recomendados, aqueles a que a marca propõe vender. Os preços de compra não são fornecidos nem por API nem nas exportações.

Posso usar as fotografias no meu site?

Sim, é a razão mais comum para contratar o catálogo. A API devolve ligações diretas para as imagens; nas exportações vem um arquivo com os ficheiros e o respetivo índice.

Com que frequência os dados são atualizados?

O catálogo cresce continuamente, à medida que chegam dados das marcas. A API tem um método que devolve apenas o que mudou desde uma data: não é preciso voltar a descarregar tudo.

Como se paga?

Para já emitimos fatura: ainda não há pagamento com cartão no site. Quando houver, os clientes ativos não terão de mudar nada.

Também há lentes de contacto?

Sim, numa secção própria: curva base, potência, cilindro, eixo, adição, embalagem e preço. Não há fotografias de lentes na base — acrescentariam pouco.