Consulta de URLs

Para consultar as URLs dos produtos é possivel consultar de forma geral, ou seja, onde é listado todos os produtos ou variações e suas respectivas urls.

Para consulta de produtos ou variações são feitas consultas especificas conforme apresentados a baixo:

Consulta de URLs de produtos:

Neste consulta será apresentado a listagem de todas as urls dos produtos.

GET /urls​/products

Example Request:

curl --request GET \
--url https://api.skyhub.com.br/urls/products \
--header 'accept: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Query Parameters

Name

Type

Required

Description

Example

channels[]

String

Optional

marca B2W

Submarino, Lojas Americanas, Shoptime

scroll_id

String

Optional

ID apresentado para paginar

gdgrdhsegfdhsdhfth

As Querys mencionadas acima são de uso opcional e para filtrar por uma marca especifica da B2W e para paginar.

Ao fazer o primeiro GET será apresentado os primeiros 100 produtos e suas respectivas urls. Utilizando o scroll_id será possivel acessar as demais páginas.

200 - Success

{
"products": [{
"sku": "MEGAFONE-PRETO",
"channels": [{
"name": "Lojas Americanas",
"href": "http://www.americanas.com.br/busca?conteudo=29593322"
},
{
"name": "Submarino",
"href": "http://www.submarino.com.br/busca?conteudo=29593322"
},
{
"name": "Shoptime",
"href": "http://www.shoptime.com.br/busca?conteudo=29593322"
}
],
"variations": []
},
{
"sku": "MEGAFONEPRETO-01",
"channels": [{
"name": "Lojas Americanas",
"href": "http://www.americanas.com.br/busca?conteudo=28409071"
},
{
"name": "Submarino",
"href": "http://www.submarino.com.br/busca?conteudo=28409071"
},
{
"name": "Shoptime",
"href": "http://www.shoptime.com.br/busca?conteudo=28409071"
}
],
"variations": []
} ],
"scroll_id": "cXVlcnlUaGVuRmV0Y2g7NTsyNzA2MTIxNTo4M2VJb3NPVlJVMjJsUFltUXB3VHN3OzI2MTk0ODk4OmlVX2ZhZnZHVEk2aUo4c2ZGaE9LVFE7MjYxOTQ4OTY6aVVfZmFmdkdUSTZpSjhzZkZoT0tUUTsyNjE5NDg5NzppVV9mYWZ2R1RJNmlKOHNmRmhPS1RROzI4MzAzNTM0OmdhdmtmZV90VFA2Y0RMQ3VyY21Zd1E7MDs="
}

Consulta de URL por produto:

Através desta chamada será possivel consultar a url de um produto especifico, ou seja, não é necessário lista os produtos e procurar.

GET /urls​/products​/{sku}

Example Request:

curl --request GET \
--url https://api.skyhub.com.br/urls/products/{sku} \
--header 'accept: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Path Parâmeters:

Name

Type

Required

Description

Example

sku

String

Required

sku do produto

sku123

Query Parameters

Name

Type

Required

Description

Example

channels[]

String

Optional

marca B2W

Submarino, Lojas Americanas, Shoptime

Responses:

200 - Success

{
"sku": "100",
"channels": [
{
"name": "Lojas Americanas",
"href": "http://www.americanas.com.br/busca?conteudo=111981497"
},
{
"name": "Submarino",
"href": "http://www.submarino.com.br/busca?conteudo=111981497"
},
{
"name": "Shoptime",
"href": "http://www.shoptime.com.br/busca?conteudo=111981497"
}
],
"variations": []
}

404 Not Found

{
"error": "Desculpe, não foram encontrados resultados."
}

Consulta de URLs de variações:

Neste consulta será apresentado todas as variações de um produto através da chamada:

GET ​/urls​/products​/{sku}​/variations

Example Request:

curl --request GET \
--url https://api.skyhub.com.br/urls/products/{sku}/variations \
--header 'accept: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Path Parâmeters:

Name

Type

Required

Description

Example

sku

String

Required

sku do produto

sku123

Query Parameters

Name

Type

Required

Description

Example

channels[]

String

Optional

marca B2W

Submarino, Lojas Americanas, Shoptime

Responses:

200 - Success

{
"variations": [
{
"sku": "var_x",
"channels": [
{
"name": "Submarino",
"href": "http://www.submarino.com.br/busca?conteudo=VAR_X"
},
{
"name": "Lojas Americanas",
"href": "http://www.americanas.com.br/busca?conteudo=VAR_X"
},
{
"name": "Shoptime",
"href": "http://www.shoptime.com.br/busca?conteudo=VAR_X"
}
]
},
{
"sku": "var_y",
"channels": [
{
"name": "Submarino",
"href": "http://www.submarino.com.br/busca?conteudo=VAR_Y"
},
{
"name": "Lojas Americanas",
"href": "http://www.americanas.com.br/busca?conteudo=VAR_Y"
},
{
"name": "Shoptime",
"href": "http://www.shoptime.com.br/busca?conteudo=VAR_Y"
}
]
}
]
}

404 Not Found

{
"error": "Desculpe, não foram encontrados resultados."
}

Consulta de URL por variação:

Com esta chamada será possível fazer a consulta por uma variação em especifico. Por exemplo:

O produto possui 3 variações, mas quer consultar apenas 1 delas. Basta utilizar a chamada:

GET /urls​/products​/{sku}​/variations​/{variation_sku}

Example Request:

curl --request GET \
--url https://api.skyhub.com.br/urls/products/{sku}/variations/{variation_sku} \
--header 'accept: application/json' \
--header 'x-accountmanager-key: SUAXACCOUNT' \
--header 'x-api-key: SuaApiKey' \
--header 'x-user-email: seu@email.com'

Request Headers:

Name

Type

Required

Description

Example

accept

String

Required

O formato que você deseja receber o retorno da requisição

application/json

x-user-email

String

Required

E-mail da loja

seu@email.com

x-api-key

String

Required

Token da loja

SuaApiKey

x-accountmanager-key

String

Required

Código identificador da sua Integração

SUAXACCOUNT

Path Parâmeters:

Name

Type

Required

Description

Example

sku

String

Required

sku do produto

sku123

variation_sku

String

Required

sku da variação

var111

Query Parameters

Name

Type

Required

Description

Example

channels[]

String

Optional

marca B2W

Submarino, Lojas Americanas, Shoptime

Responses:

200 - Success

{
"sku": "variation",
"channels": [
{
"name": "Submarino",
"href": "http://www.submarino.com.br/busca?conteudo=VARIATION"
},
{
"name": "Lojas Americanas",
"href": "http://www.americanas.com.br/busca?conteudo=VARIATION"
},
{
"name": "Shoptime",
"href": "http://www.shoptime.com.br/busca?conteudo=VARIATION"
}
]
}

404 Not Found

{
"error": "Desculpe, não foram encontrados resultados."
}