Essa funcionalidade foi descontinuada de nossa API, caso tenha sido impactado entre em contato conosco através do email [email protected]
Perguntas e Respostas é a Endpoint criada para que os sellers B2W interajam com os clientes a respeito de quaisquer duvidas sobre o produto que esta visualizando.
Nesta função, os sellers que pertencem ao BuyBox poderão responder, rejeitar, listar perguntas.
Não é possível excluir uma pergunta para B2W;
O retorno do "product_sku" e "platform_sku" é referente ao ID B2W, ou seja, será necessário acessar o portal B2W para identificar o sku do produto.
Retorna somente uma plataforma por requisição;
A paginação é feita utilizando o cursor que esta presente em todas as requests de listar. Cada cursor sempre aponta para a próxima página em apenas um único sentido.
Ao utilizar o cursor, os parâmetros de filtros são ignorados pois o cursor sempre refere-se aos filtros da primeira consulta.
Por exemplo:
{"status": "UNANSWERED", "product_sku": "33629401", "platform_sku": "33629401", "platform": "B2W",…},{"status": "UNANSWERED", "product_sku": "15606067", "platform_sku": "15606067", "platform": "B2W",…}],"qty": 50,"cursor": "eyJzdGF0dXMiOiJVTkFOU1dFUkVEIiwib2Zmc2V0Ijo1MSwibGltaXQiOjUwfQ=="}
Os endpoints de perguntas/respostas tem a responsabilidade de expor dados por plataforma, segue a lista de plataformas suportadas:
Meli
B2W
Segue a baixo como efetuar cada função e suas respectivas endpoints.
Tem como função retornar as perguntas relacionadas ao seller, ou seja, ao BuyBox.
Por exemplo:
Existem 3 sellers que estão no BuyBox, neste caso a pergunta que o cliente poderá ser respondido por quaisquer dos 3 sellers, desde de que não esteja respondido.
Para listar deve ser utilizado a endpoint:
GET /questions
Filtros:
status: Estado atual da pergunta
platform: De qual marketplace esta buscando as informações.
curl -X GET \https://api.skyhub.com.br/questions \-H 'accept: application/json' \-H 'cache-control: no-cache' \-H 'content-type: application/json' \-H 'x-accountmanager-key: SUAXACCOUNT' \-H 'x-api-key: YOUR API KEY HERE' \-H 'x-user-email: [email protected]_EMAIL.COM'
Request Headers
Name | Type | Required | Description | Example |
accept | String | Required | application/json | application/json |
Content-type | String | Required | application/json | application/json |
x-user-email | String | Required | E-mail da loja | |
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 |
status | String | Optional | Filtra as mensagens pelos seus status Valores possíveis:
| UNANSWERED |
platform | String | Required | Filtro para retornar somente as mensagens de uma plataform específica. Valores possíveis
| B2W |
cursor | String | Optional | Utilizado para fazer a paginação das perguntas. Caso este parâmetro esteja presente, os parâmetros de status e platform serão ignorados. | eyJwbGF0Zm9ybSI6Ik1lbGkiLCJvZmZzZXQiO |
Responses:
200 - Success
{"questions": [{"status": "UNANSWERED","product_sku": "29267596","platform_sku": "29267596","platform": "B2W","customer": {"name": "Rodrigo"},"created_at": "2019-10-10T16:58:07.297Z","code": "B2W-5d9f631fec233600327e3205","body": "Ola boa tarde...\nFiz o pagamento dos autofalantes ontem ainda e ate agora nao foi despachado! Vocês não tem eles a pronta entrega?","answers": [],"answer": {}},{"status": "UNANSWERED","product_sku": "23237068","platform_sku": "23237068","platform": "B2W","customer": {"name": "Ronaldo"},"created_at": "2019-10-10T12:06:52.758Z","code": "B2W-5d9f1edca8bad6003227cbe5","body": "Nao poderia retirar em alguma loja de vcs ??? Preciso muito rapido","answers": [],"answer": {}}],"qty": 50,"cursor": "eyJvZmZzZXQiOjUxLCJsaW1pdCI6NTB9"}
400 - BAD REQUEST
Não foi possível processar a requisição
401 - AUTHENTICATION FAILED
Não foi possível realizar a autenticação. Verifique se as credenciais de acesso estão corretas.
500 - INTERNAL SERVER ERROR
Caso ocorra algum erro interno no servidor
Tem como função visualizar as perguntas através do code, que é disponibilizado ao efetuar o GET /questions. Por exemplo:
"code": "B2W-5d9e80ed9df1b1002c39716a"
Neste caso é necessário utilizar a seguinte endpoint:
GET /questions/{code}
Example Request:
curl -X GET \https://api.skyhub.com.br/questions/{code} \-H 'accept: application/json' \-H 'cache-control: no-cache' \-H 'content-type: application/json' \-H 'x-accountmanager-key: SUAXACCOUNT' \-H 'x-api-key: YOUR API KEY HERE' \-H 'x-user-email: [email protected]_EMAIL.COM'
Request Headers
Name | Type | Required | Description | Example |
accept | String | Required | application/json | application/json |
Content-type | String | Required | application/json | application/json |
x-user-email | String | Required | E-mail da loja | |
x-api-key | String | Required | Token da loja | SuaApiKey |
x-accountmanager-key | String | Required | Código identificador da sua Integração | SUAXACCOUNT |
Responses:
200 - SUCCESS
400 - BAD REQUEST
401 - AUTHENTICATION FAILED
404 - NOT FOUND
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented
Tem como função responder perguntas através do code. Neste caso é necessário utilizar a seguinte endpoint:
POST /questions/{code}
curl -X GET \https://api.skyhub.com.br/questions/{code} \-H 'accept: application/json' \-H 'cache-control: no-cache' \-H 'content-type: application/json' \-H 'x-accountmanager-key: SUAXACCOUNT' \-H 'x-api-key: YOUR API KEY HERE' \-H 'x-user-email: [email protected]_EMAIL.COM'
Request Headers
Name | Type | Required | Description | Example |
accept | String | Required | application/json | application/json |
Content-type | String | Required | application/json | application/json |
x-user-email | String | Required | E-mail da loja | |
x-api-key | String | Required | Token da loja | SuaApiKey |
x-accountmanager-key | String | Required | Código identificador da sua Integração | SUAXACCOUNT |
Tem como função retornar as respostas de uma pergunta através do code.
Neste caso é necessário utilizar a seguinte endpoint:
GET /questions/{code}/answers
curl -X GET \https://api.skyhub.com.br/questions/{code}/answers \-H 'accept: application/json' \-H 'cache-control: no-cache' \-H 'content-type: application/json' \-H 'x-accountmanager-key: SUAXACCOUNT' \-H 'x-api-key: YOUR API KEY HERE' \-H 'x-user-email: [email protected]_EMAIL.COM'
Request Headers
Name | Type | Required | Description | Example |
accept | String | Required | application/json | application/json |
Content-type | String | Required | application/json | application/json |
x-user-email | String | Required | E-mail da loja | |
x-api-key | String | Required | Token da loja | SuaApiKey |
x-accountmanager-key | String | Required | Código identificador da sua Integração | SUAXACCOUNT |
Tem como função retornar as perguntas com sumário baseado no produto. Os status do sumário serão:
REJECTED
UNANSWERED
APPROVED
Rejected e Approved: quantidade de respostas que o seller deu e que foram aprovadas ou rejeitadas pela moderação.
Unanswered: quantidade de perguntas que o seller não respondeu
Neste caso é necessário utilizar a seguinte endpoint:
GET /questions/products/summaries
curl -X GET \https://api.skyhub.com.br/questions/products/summaries \-H 'accept: application/json' \-H 'cache-control: no-cache' \-H 'content-type: application/json' \-H 'x-accountmanager-key: SUAXACCOUNT' \-H 'x-api-key: YOUR API KEY HERE' \-H 'x-user-email: [email protected]_EMAIL.COM'
Request Headers
Name | Type | Required | Description | Example |
accept | String | Required | application/json | application/json |
Content-type | String | Required | application/json | application/json |
x-user-email | String | Required | E-mail da loja | |
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 |
platform | String | Required | Filtro para retornar somente as mensagens de uma plataform específica. Valores possíveis
| B2W |
200 - SUCCESS
401 - AUTHENTICATION FAILED
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented
{"summary": {"UNANSWERED": 1,"REJECTED": 2},"name": "Mp3 Player Roadstar 2 Din Bluetooth Usb Micro Sd Auxiliar P2 Rádio Fm Rs-3707br","image": "https://images-americanas.b2w.io/produtos/01/00/img3/108424/7/108424700_1SZ.jpg","id": "108424697"},{"summary": {"UNANSWERED": 1},"name": "Para-choque Impulsão Quebra Mato S10 2012 2013 2014 2015 2016 2017 2018 Grafite","image": "https://images-americanas.b2w.io/produtos/01/00/oferta/60681/9/60681918_1SZ.jpg","id": "60681921"
Responsável por retornar as perguntas especificas do produto informado.
Será possível verificar o ID do produto através da endpoint: GET /questions/products/summaries.
Para obter o retorno das perguntas será necessário utilizar a seguinte endpoint:
GET /questions/product/:id
curl -X GET \https://api.skyhub.com.br/questions/product/{id} \-H 'accept: application/json' \-H 'cache-control: no-cache' \-H 'content-type: application/json' \-H 'x-accountmanager-key: SUAXACCOUNT' \-H 'x-api-key: YOUR API KEY HERE' \-H 'x-user-email: [email protected]_EMAIL.COM'
Request Headers
Name | Type | Required | Description | Example |
accept | String | Required | application/json | application/json |
Content-type | String | Required | application/json | application/json |
x-user-email | String | Required | E-mail da loja | |
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 |
platform | String | Required | Filtro para retornar somente as mensagens de uma plataform específica. Valores possíveis
| B2W |
200 - SUCCESS
401 - AUTHENTICATION FAILED
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented
{"questions": [{"status": "APPROVED","product_sku": "71028130","platform_sku": "71028130","platform": "B2W","customer": {"name": "Fabio"},"created_at": "2019-09-18T10:15:19.861Z","code": "B2W-5d8203b7b983f70032a4faf4","body": "Tem na cor preta?","answers": [],"answer": {}}],"qty": 1,"cursor": null}
Tem como função retornar a quantidade de perguntas não respondidas de acordo com o BuyBox.
Para obter o retorno é necessário utilizar a enpoint:
GET /questions/count_unanswered_by_all
curl -X GET \https://api.skyhub.com.br/questions/count_unanswered_by_all \-H 'accept: application/json' \-H 'cache-control: no-cache' \-H 'content-type: application/json' \-H 'x-accountmanager-key: SUAXACCOUNT' \-H 'x-api-key: YOUR API KEY HERE' \-H 'x-user-email: [email protected]_EMAIL.COM'
Request Headers
Name | Type | Required | Description | Example |
accept | String | Required | application/json | application/json |
Content-type | String | Required | application/json | application/json |
x-user-email | String | Required | E-mail da loja | [email protected]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 |
platform | String | Required | Filtro para retornar somente as mensagens de uma plataform específica. Valores possíveis
| B2W |
200 - SUCCESS
401 - AUTHENTICATION FAILED
422 - UNPROCESSABLE ENTITY
500 - INTERNAL SERVER ERROR
501 - Not Implemented
{"unansweredQuestions": 484}