Diretrizes para entrar em contato com o suporte do provedor de soluções

Conte-nos o que você está tentando fazer, o que aconteceu em vez disso e as etapas que levaram a isso.

Para um erro de SP-API, inclua estes detalhes para uma chamada afetada:

• O endpoint completo, incluindo o host e o caminho, e o método HTTP
• O nome, a versão e a operação da API
• O ID da solicitação e a data e hora UTC da chamada
• O código de status HTTP e a resposta completa ao erro
• Seu ID do aplicativo, o ID do marketplace e a região do SP-API
• O token de comerciante do vendedor para quem você está ligando
• Se a chamada foi uma solicitação de sandbox
• O ID do feed ou ID do relatório para problemas da API Feeds ou da API de Relatórios, ou o ID de envio para problemas da API Listings Items
• Cabeçalhos e corpos de solicitação e resposta, com cada valor de credencial substituído por

Recomendamos reproduzir a chamada no Postman, o que mostra se o problema continua fora do seu aplicativo. Para coletar os detalhes, abra o Postman Console, selecione a solicitação e expanda a solicitação e a resposta.

Copie os detalhes em um arquivo.txt e substitua cada valor de credencial por <Redacted>antes de anexá-lo. Para configurar, acesse Usando o Postman para vender modelos de API de parceiros.

Se o erro ocorrer em um site ou página do portal, como o Portal do Provedor de Soluções, anexe um arquivo HAR (Arquivo HTTP) higienizado que registre o erro. Um arquivo HAR registra a atividade de rede do seu navegador enquanto a página é carregada.
Para gravar um no Google Chrome:

1. Abra uma janela anônima e vá para a página em que o erro ocorre. Não repita a ação que falhou ainda.
2. Abra as Ferramentas do Desenvolvedor (F12 no Windows, Cmd+Option+I no Mac) e selecione a guia Rede.
3. Selecione Preservar registro e clique em Limpar para iniciar uma gravação limpa.
4. Repita as etapas que causam o erro.
5. Clique com o botão direito do mouse nas linhas gravadas e selecione Copiar tudo como HAR (higienizado). Cole o resultado em um arquivo de texto sem formatação e salve-o com a terminação.har.

A opção higienizada remove cookies e tokens de login. Ele não remove nada que você digita na página. Não insira uma senha real, informações de pagamento ou identificação pessoal durante a gravação, a menos que seja necessário reproduzir o erro. Para obter etapas detalhadas, consulte Como faço para criar arquivos HAR e logs de console a partir do meu navegador para um caso do AWS Support?

Não inclua tokens de atualização, tokens de acesso, tokens de dados restritos, segredos de clientes, credenciais da AWS, cabeçalhos de autorização, cookies ou URLs assinados em um caso, anexo ou captura de tela. Para obter orientação, acesse Protegendo credenciais confidenciais.

Conte-nos quais soluções você já experimentou e por que elas não funcionaram. Dessa forma, não sugerimos algo que você já tenha descartado e, às vezes, uma pequena alteração em uma de suas etapas corrige o problema.

• Menos útil: tentamos várias coisas, mas nada funciona.
• Mais útil: seguimos as etapas em [URL da página] e a última etapa retornou o erro XXXX.

Diga-nos o que você deseja alcançar e inclua a mensagem de erro completa. Uma pergunta de uma linha geralmente leva a perguntas complementares, o que retarda a resolução.

• Menos útil: não consigo receber pedidos. O que devo fazer?
• Mais útil: quando chamo getOrders na API de pedidos do Postman, recebo “Erro: parâmetros inválidos”. O timestamp é YYYY-MM-DD HH:MM UTC e o ID da solicitação é XXXXXXXX. Quero recuperar todos os pedidos criados nas últimas 24 horas.

Analisamos todas as causas possíveis, incluindo o método de chamada, permissões ausentes e problemas temporários de serviço. Também podemos sugerir uma forma diferente de alcançar sua meta.

Anexe registros de erros e capturas de tela ao abrir a caixa. Essa é a maneira mais rápida de reduzir o tempo de resolução. Se você alterou o formato do registro, conte-nos o que mudou. Antes de anexar um registro ou captura de tela, verifique se ele não mostra nenhuma credencial.

• Tipo de API: selecione o tipo de API sobre o qual sua pergunta se refere.
• Tipo de problema: selecione a categoria adequada à sua pergunta.
• Seção de API: se você selecionar Erro de API como o tipo de problema, selecione a API sobre a qual sua pergunta se refere.
• Descreva o problema: Siga as orientações em Descreva seu problema.
• IDs de vendedor ou desenvolvedor relacionados: insira o ID do vendedor ou do desenvolvedor que tem o problema.
• Marketplace (s) envolvido (s): entre na loja onde o problema ocorre.
• Operações de API relacionadas: insira a operação que você está chamando, por exemplo, getOrders.
• ID (s) do aplicativo SP-API/MWS: insira o ID do aplicativo.

Um membro da equipe lida com um caso por vez, para que perguntas não relacionadas sejam respondidas mais rapidamente em casos separados. Por exemplo, abra um caso sobre a recuperação de dados e um caso separado sobre limites de taxa. Mantenha perguntas estreitamente relacionadas em um caso. Nosso membro da equipe pode sugerir a divisão de um caso.

Se você perguntar sobre um recurso que foi excluído, talvez não possamos investigar completamente a causa.

As falhas são imprevisíveis e inevitáveis. Embora nossa equipe de suporte técnico se esforce para analisar as causas e reduzir a incidência de falhas na infraestrutura, é difícil evitar completamente a ocorrência de falhas.

Por esse motivo, recomendamos “Design For Failure” (design para falhas).

Não fornecemos explicações detalhadas sobre falhas. Isso ocorre porque acreditamos que fornecer informações detalhadas sobre a causa de uma falha não afeta a solução alternativa do cliente e não é essencial para resolver o problema do cliente. Em vez disso, nosso objetivo é resolver seus problemas rapidamente, mostrando como utilizar adequadamente nossos serviços de monitoramento e priorizar a recuperação primária.

O desempenho depende do ambiente e da carga de trabalho, por isso não podemos fornecer benchmarks gerais. Recomendamos medir o desempenho em seu próprio ambiente.

Compartilhe solicitações de novos recursos ou melhorias em seu caso de suporte e nós as encaminharemos para a equipe de desenvolvimento. Não podemos prometer criar uma solicitação ou notificá-lo quando ela for criada, mas seu feedback nos ajuda a melhorar.

Se nossa resposta resolveu seu problema, ou se você mesmo o resolveu, anote a resolução do caso e encerre-o. Compartilhar o que funcionou, incluindo qualquer correção que não sugerimos, nos ajuda a resolver problemas semelhantes para outros desenvolvedores.