Pular para o conteúdo principal
Toda resposta da API, de sucesso ou de erro, traz o header Request-Id com o identificador único da requisição:
  • Mesmo valor no corpo do erro. Num erro, error.request_id é igual ao header Request-Id.
  • Gerado pela Zouti. Um Request-Id enviado pelo cliente é ignorado: a resposta sempre traz um identificador novo.
  • Guarde no seu log. Registre o Request-Id de cada chamada, ao menos das que falham. Com ele, o suporte encontra a requisição exata.
  • Informe ao suporte. Ao relatar um problema, envie o Request-Id, o endpoint chamado e o horário aproximado.
Toda resposta da própria API traz Request-Id. As respostas geradas na borda (balanceador de carga e WAF), antes de a requisição chegar à API, vêm sem corpo JSON e sem Request-Id:
  • o 400 em texto puro de uma requisição em HTTP;
  • o 429 do limite de volume por IP (veja Limites de requisição);
  • o 403 da proteção do WAF contra entradas maliciosas conhecidas;
  • um 5xx do balanceador de carga, como 502, 503 ou 504 quando a API não responde.
Nesses casos, registre o horário, o endpoint e o status para informar ao suporte.