Questions
Questions é de uso exclusivo para lojas integradas com o Mercado Livre. Ela é a Endpoint para perguntas e respostas na pré-venda.
Neste função é possivel listar, visualizar de acordo com o identificador, deletar e responder as perguntas.
Segue a baixo como efetuar cada função e suas respectivas endpoints.

List Questions:

Para listar deve ser utilizado a endpoint:
1
GET /questions
Copied!
Filtros
  • status: Estado atual da pergunta
  • platform: De qual marketplace esta buscando as informações.
Paginaçã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.

Example Request:

1
curl --request GET \
2
--url 'https://api.skyhub.com.br/questions' \
3
--header 'accept: application/json' \
4
--header 'x-accountmanager-key: SUAXACCOUNT' \
5
--header 'x-api-key: YOUR API KEY HERE' \
6
--header 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
Content-type
String
Required
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:
  • ANSWERED
  • UNANSWERED
  • FINISHED
UNANSWERED
platform
String
Required
Filtro para retornar somente as mensagens de uma plataform específica.
Valores possíveis
  • Meli
application/json
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.
eyJwbGF0Zm9ybSI6Ik1lbGkiLCJvZmZzZXQiOj
Responses
200 - Success
1
{
2
"questions": [
3
{
4
"code": "Meli-9999900001",
5
"status": "ANSWERED",
6
"product_sku": "SKU0001",
7
"platform": "Meli",
8
"platform_sku": "MLB9999900001",
9
"customer": {
10
"name": "Test nickname"
11
},
12
"body": "Question about product SKU0001",
13
"created_at": "2019-02-04T12:06:12.000-03:00",
14
"answer": {
15
"body": "Answer of question Meli-9999900001",
16
"created_at": "2019-02-04T16:06:12.000-03:00"
17
}
18
},
19
{
20
"code": "Meli-9999900002",
21
"status": "UNANSWERED",
22
"product_sku": "SKU0001",
23
"platform": "Meli",
24
"platform_sku": "MLB9999900001",
25
"customer": {
26
"name": "Test nickname"
27
},
28
"body": "Second question about product SKU0001",
29
"created_at": "2019-02-04T18:06:12.000-03:00",
30
"answer": {}
31
}
32
],
33
"qty": 2,
34
"cursor": "JUICVGHUGCYXRFChugvijCutgfCyuxcYUFxufgxyfuXyfuXyfXyfgCcu=="
35
}
Copied!
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

Show Question

Tem como função visualizar as perguntas através do identificador. Neste caso é necessário utilizar a seguinte endpoint:
1
GET /questions/{code}
Copied!
Example Request:
1
curl --request GET \
2
--url https://api.skyhub.com.br/questions/{code} \
3
--header 'accept: application/json' \
4
--header 'x-accountmanager-key: XACCOUNT' \
5
--header 'x-api-key: YOUR API KEY HERE' \
6
--header 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
Content-type
String
Required
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
1
{
2
"code": "Meli-9999900001",
3
"status": "ANSWERED",
4
"product_sku": "SKU0001",
5
"platform": "Meli",
6
"platform_sku": "MLB9999900001",
7
"customer": {
8
"name": "Test nickname"
9
},
10
"body": "Question about product SKU0001",
11
"created_at": "2019-02-04T12:06:12.000-03:00",
12
"answer": {
13
"body": "Answer of question Meli-9999900001",
14
"created_at": "2019-02-04T16:06:12.000-03:00"
15
}
16
}
Copied!
401 - AUTHENTICATION FAILED
404 - NOT FOUND
500 - INTERNAL SERVER ERROR

Question Answer

Tem como função responder perguntas. Neste caso é necessário utilizar a seguinte endpoint:
1
POST /questions​/{code}​/answer
Copied!
Example Request:
1
curl --request POST \
2
--url https://api.skyhub.com.br/questions/{code} \
3
--header 'accept: application/json' \
4
--header 'content-type: application/json' \
5
--header 'x-accountmanager-key: XACCOUNT' \
6
--header 'x-api-key: YOUR API KEY HERE' \
7
--header 'x-user-token: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
Content-type
String
Required
multipart/form-data
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

Delete Question

Tem como função deletar a pergunta cujo o id foi especificado, de acordo com a endpoint a baixo:
1
DELETE /questions/{code}
Copied!
Example Request:
1
curl --request DELETE \
2
--url https://api.skyhub.com.br/questions/{code} \
3
--header 'accept: application/json' \
4
--header 'x-accountmanager-key: XACCOUNT' \
5
--header 'x-api-key: YOUR API KEY HERE' \
6
--header 'x-user-email: [email protected]_EMAIL.COM'
Copied!
Request Headers
Name
Type
Required
Description
Example
accept
String
Required
application/json
Content-type
String
Required
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
401 - AUTHENTICATION FAILED
404 - NOT FOUND
500 - INTERNAL SERVER ERROR
Last modified 2yr ago