快工助手跨境电商知识与商机助手

Ferramenta de Log da Open Platform

Shopee 官方资料 · Shopee Open Platform 开发者指南 · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.developer_guide
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/api_doctopic/apitopic/api-guidelines-and-flowstopic/developer

资料正文

§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

  1. Selecione o partner_id que deseja verificar os logs;

  2. 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;

  3. O campo API Path pode ser utilizado para filtrar as chamadas no seu histórico de logs;

  4. O campo Request Time (UTC-03:00) pode ser utilizado para filtrar as chamadas pelo intervalo de datas;

  5. Clique em Search;

  6. Clique em Raise a Ticket;

  7. 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
  1. Basta preencher o campo Question Description com a sua dúvida;

  2. Caso necessário, você poderá anexar arquivos relevantes para a abertura desse ticket, basta adicionar na seção File;

  3. Após preencher, clique em Submit e complete o Captcha;

  4. 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:

  1. 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."

  2. 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."

  3. 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.

#