Para realizar uma consulta na API devemos utilizar o método GET, preenchendo os devidos headers no endpoint abaixo:
https://api.skyhub.com.br/products/{SKU}
Request headers:
Key
Value
Example request:
curl --location -g --request GET 'https://api.skyhub.com.br/products/{SKU}' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Response esperado:
200 [Success] - OK: Haverá um response body com a estrutura do SKU consultado:
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:
https://api.skyhub.com.br/products
Example request:
curl --location --request GET 'https://api.skyhub.com.br/products' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Response esperado:
200 [Success] - OK: O retorno é semelhante ao da pesquisa anterior, porém serão visualizados todos os SKUs da conta e abaixo temos um exemplo resumido do retorno esperado:
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:
curl --location -g --request GET 'https://api.skyhub.com.br/products?cursor=cXVlcnlUa..........wOw=="
}' \
--header 'X-User-Email: email_de_usuario' \
--header 'X-Api-Key: token_de_integracao de sua conta SkyHub' \
--header 'X-Accountmanager-Key: token_account único de cada Plataforma/ERP' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
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:
