Estes números são lidos diretamente da base de dados e atualizam-se sozinhos — não são valores escritos na página.
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.
Dois caminhos para equipas diferentes: uma chamada a partir do seu sistema ou um ficheiro que qualquer pessoa abre.
Para integrar o site, o sistema de inventário ou os anúncios nos marketplaces.
Para quem precisa de um ficheiro e não de uma integração. Sem programador.
Imagens de produto em fundo limpo, prontas para a montra ou o marketplace.
Dados reais do catálogo, não um exemplo da documentação.
Pedido
GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2Resposta
{
"data": [
{
"ean": "8056597843119",
"brand": "RAY-BAN",
"model": "RX3717V",
"name": "RX3717V 2502 54",
"color": "CLEAR",
"size": "54",
"gender": "UNISEX",
"material": "METAL",
"rrp": 173,
"currency": "EUR",
"status": "ACTIVE",
"images": [
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_1.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_2.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_3.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_4.jpg"
]
},
{
"ean": "8053672819762",
"brand": "RAY-BAN",
"model": "RB4195M",
"name": "RB4195M F602H2 52",
"color": "GREEN MIRROR SILVER POLARISED+",
"size": "52",
"gender": "MAN",
"material": "PEEK",
"rrp": 326,
"currency": "EUR",
"status": "ACTIVE",
"images": [
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_1.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_2.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_3.jpg",
"https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_4.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.
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.
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.
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.
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.
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.
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.