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: MUDAR@SEU_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

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

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: MUDAR@SEU_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

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

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: MUDAR@SEU_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

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

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: MUDAR@SEU_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

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

Responses

200 - SUCCESS

401 - AUTHENTICATION FAILED

404 - NOT FOUND

500 - INTERNAL SERVER ERROR