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.
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.
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:
| UNANSWERED |
platform | String | Required | Filtro para retornar somente as mensagens de uma plataform específica. Valores possíveis
| 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
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
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
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