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:
GET /questions
 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:
curl --request GET \
  --url 'https://api.skyhub.com.br/questions' \
  --header 'accept: application/json' \
  --header 'x-accountmanager-key: SUAXACCOUNT' \
  --header 'x-api-key: YOUR API KEY HERE' \
  --header 'x-user-email: [email protected]_EMAIL.COM'
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
{
  "questions": [
    {
      "code": "Meli-9999900001",
      "status": "ANSWERED",
      "product_sku": "SKU0001",
      "platform": "Meli",
      "platform_sku": "MLB9999900001",
      "customer": {
        "name": "Test nickname"
      },
      "body": "Question about product SKU0001",
      "created_at": "2019-02-04T12:06:12.000-03:00",
      "answer": {
        "body": "Answer of question Meli-9999900001",
        "created_at": "2019-02-04T16:06:12.000-03:00"
      }
    },
    {
      "code": "Meli-9999900002",
      "status": "UNANSWERED",
      "product_sku": "SKU0001",
      "platform": "Meli",
      "platform_sku": "MLB9999900001",
      "customer": {
        "name": "Test nickname"
      },
      "body": "Second question about product SKU0001",
      "created_at": "2019-02-04T18:06:12.000-03:00",
      "answer": {}
    }
  ],
  "qty": 2,
  "cursor": "JUICVGHUGCYXRFChugvijCutgfCyuxcYUFxufgxyfuXyfuXyfXyfgCcu=="
}
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:
GET /questions/{code}
Example Request:
curl --request GET \
  --url https://api.skyhub.com.br/questions/{code} \
  --header 'accept: application/json' \
  --header 'x-accountmanager-key: XACCOUNT' \
  --header 'x-api-key: YOUR API KEY HERE' \
  --header 'x-user-email: [email protected]_EMAIL.COM'
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
{
  "code": "Meli-9999900001",
  "status": "ANSWERED",
  "product_sku": "SKU0001",
  "platform": "Meli",
  "platform_sku": "MLB9999900001",
  "customer": {
    "name": "Test nickname"
  },
  "body": "Question about product SKU0001",
  "created_at": "2019-02-04T12:06:12.000-03:00",
  "answer": {
    "body": "Answer of question Meli-9999900001",
    "created_at": "2019-02-04T16:06:12.000-03:00"
  }
}
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:
POST /questions​/{code}​/answer
Example Request:
curl --request POST \
  --url https://api.skyhub.com.br/questions/{code} \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-accountmanager-key: XACCOUNT' \
  --header 'x-api-key: YOUR API KEY HERE' \
  --header 'x-user-token: [email protected]_EMAIL.COM'
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:
DELETE /questions/{code}
Example Request:
curl --request DELETE \
  --url https://api.skyhub.com.br/questions/{code} \
  --header 'accept: application/json' \
  --header 'x-accountmanager-key: XACCOUNT' \
  --header 'x-api-key: YOUR API KEY HERE' \
  --header 'x-user-email: [email protected]_EMAIL.COM'
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 erros de Sincronização e Produção
Next - Perguntas e Respostas B2W
Perguntas e Respostas B2W
Last updated 2 years ago
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