来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 Ferramenta de Log da Open Platform
A Shopee Open Platform possui uma ferramenta de log, que disponibiliza para o desenvolvedor o acesso aos logs dos últimos 7 dias do seu partner_id que já está em produção (Live). Atualmente, é possível consultar os dados dos logs a partir de 20 de Setembro de 2022.
§2 Acesso aos Logs da API
Acesso aos Logs da API
Acesse a ferramenta clicando aqui.
- Podem ser consultados os logs da API correspondente ao seu Live Partner dos últimos sete dias, se as solicitações retornaram sucesso ou não;
- Poderá verificar no log os parâmetros da request/response, os códigos de status e outras informações da API que foi chamada;
- Suporta pesquisa rápida através do request_id da sua chamada, dessa forma poderá encontrar com precisão o log pelo request_id que foi retornado no parâmetro de resposta da API;
- Suporta pesquisa por palavra-chave, por exemplo, pode ser inserido na busca a string de order_sn, ou mensagem de erro para procurar nos logs;
- Abrir um chamado de forma rápida, basta clicar no botão Raise a Ticket do lado direito da lista do log, e todas as informações relevantes serão copiadas automaticamente para o formulário de abertura de ticket;
- Visualizar a documentação da API rapidamente, basta clicar no botão View API Detail do lado direito da lista do log, e a documentação da API será aberta em uma nova página.
§3 Abertura de chamado através da ferramenta de log da API
Abertura de chamado através da ferramenta de log da API
-
Selecione o partner_id que deseja verificar os logs;
-
Caso possua o request_id, basta copiar o request_id no campo Request ID. Caso não possua o request_id da chamada, basta utilizar a palavra-chave que deseja procurar no campo Keywords;
-
O campo API Path pode ser utilizado para filtrar as chamadas no seu histórico de logs;
-
O campo Request Time (UTC-03:00) pode ser utilizado para filtrar as chamadas pelo intervalo de datas;
-
Clique em Search;
-
Clique em Raise a Ticket;
-
Você será redirecionado para o nosso formulário de abertura de chamado, já com as informações mais relevantes, como:
- Developer Email;
- L1 Question Category;
- L2 Question Category;
- Partner ID
- API Version
- API Category
- API Name
- Request
- Response
- Request ID
-
Basta preencher o campo Question Description com a sua dúvida;
-
Caso necessário, você poderá anexar arquivos relevantes para a abertura desse ticket, basta adicionar na seção File;
-
Após preencher, clique em Submit e complete o Captcha;
-
Seu chamado terá sido submetido com sucesso.
§4 Acesso aos Logs de Push
Acesso aos Logs de Push
Acesse a ferramenta clicando aqui.
- Podem ser consultados os logs de Push correspondente ao seu Live Partner dos últimos sete dias, se o push retornou com sucesso ou não;
- Se as mensagens não foram enviadas com sucesso, será enviado o motivo na mensagem de erro.
Existem três situações em que o push não é bem sucedido:
-
Sem resposta da url de callback, mensagem de erro: "Shopee has sent the push to your callback url, but we didn't get any response with 2xx code within the requested timeout seconds, please check your service."
-
Recebemos uma resposta com um código que não é 2xx, mensagem de erro: "Shopee has sent the push to your callback url, but the response code we got from your callback url is not 2xx, please check your service."
-
Outros motivos, mensagem de erro: "System error."
É possível pesquisar por palavra-chave, por exemplo, pode ser inserido na busca a string de order_sn, ou mensagem de erro para procurar nos logs de Push.
Lembre-se de preencher todos os campos obrigatórios (campos marcados com *):
- Partner ID;
- Push Mechanism;
- Send Time (UTC-03:00) - alterar para a data desejada (disponível log dos últimos 7 dias);
- Send Result.
Caso opte por buscar por uma palavra-chave específica, basta utilizar o campo Keywords, por exemplo a order_sn, e depois basta clicar em Search. A lista de logs de push e suas informações aparecerão nos resultados.
