Criar Pergunta
Introdução
Esta seção descreve o processo para criação de perguntas no ambiente de sandbox da Open API Magalu.
Pré-requisitos
Antes de criar uma pergunta, certifique-se de atender aos seguintes requisitos:
- Utilizar um
channel_id
válido para o ambiente de sandbox; - Informar um SKU previamente cadastrados;
- Informar uma message contendo o texto da pergunta.
Escopos Necessários
Para realizar a criação de pergunta, os seguintes escopos de autenticação devem estar habilitados para o token de acesso:
services:questions-seller:write
Exemplo de Requisição
Abaixo, um exemplo de chamada utilizando cURL
para criação de uma pergunta:
curl --request POST \
--url https://api-sandbox.magalu.com/v1/samples/questions \
--header 'authorization: Bearer {{token}}' \
--header 'content-type: application/json' \
--data '{
"message": "Texto da pergunta",
"sku": "SKU123456"
}'
Neste exemplo:
message
: Conteúdo da pergunta.sku
: SKU do produto relacionado.
atenção
Certifique-se de que o produto já tenha sido previamente criado no canal de sandbox.
Cenários de Erro
Estes são exemplos de respostas de erro que podem ser retornadas durante a execução de requisições no ambiente de sandbox.
Cenário de Erro | Código HTTP | Como simular o cenário |
---|---|---|
Channel id '{channel_id}' is unknown for the Sandbox environment. | 422 | Envie uma requisição com um channel_id inválido ou inexistente no ambiente de sandbox. |
Invalid or missing parameters. | 400 | Envie a requisição com dados malformados ou omita campos obrigatórios, como message ou sku . |
Unauthorized | 401 | Utilize um token inválido ou ausente no cabeçalho da requisição. |