Produto Simples e Variável
Mostraremos nesta página como consultar produtos simples e variáveis via API
GET - Consultando um produto
Para realizar uma consulta na API devemos utilizar o método GET, preenchendo os devidos headers no endpoint abaixo:
Request headers:
X-User-Email
email_de_usuario
X-Api-Key
token_de_integracao de sua conta SkyHub
X-Accountmanager-Key
token_account único de cada Plataforma/ERP
Accept
application/json
Content-Type
application/json
Example request:
Response esperado:
200 [Success] - OK: Haverá um response body com a estrutura do SKU consultado:
Consultando todos os produtos
Além da consulta individual, também é possível listar todos os produtos criados na conta.
Para isto, basta utilizar o GET no endpoint /products sem informar um SKU, conforme abaixo:
Example request:
Response esperado:
200 [Success] - OK: O retorno é semelhante ao da pesquisa anterior, porém serão visualizados todos os SKUs não conectados da conta e abaixo temos um exemplo resumido do retorno esperado:
Filtros da consulta
Por padrão, o GET em /products retornará todos os produtos não conectados ao Marketplace. Para retornar os produtos conectados ao Marketplace, devemos filtrar com o parâmetro type "/products?filters[type]=link".
Produtos conectados são aqueles que o lojista decide por habilitar a vender. Quando conectado, o produto fica disponível (caso estoque positivo), já desconectado o lojista desabilita o produto para a venda.
Como paginar a consulta de produtos
A listagem de produtos retornará 25 itens por página. Caso a conta tenha mais que 25 produtos, será necessário fazer a paginação através do cursor, que deve ser inserido no endpoint em forma de query string.
Como montar a query?
Ao realizar o GET no /products, ao final da consulta será apresentado o campo next que trará como parâmetro o cursor, como visualizado a seguir:
Ao localizar o cursor, basta inseri-lo no endpoint para que seja possível alcançar a próxima página. Abaixo temos um exemplo de utilização da paginação:
A cada página o cursor será alterado até que chegue na última, quando a requisição retornará sucesso, porém trará um array vazio:
Last updated