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
[email protected]
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
[email protected]
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
[email protected]
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
[email protected]
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

Erros - Previous

Consulta de Erros de Sincronização e Produção

Next - Perguntas e Respostas Americanas

Perguntas e Respostas: Americanas

Last modified 2yr ago

Copy link

Contents