Solução de problemas de solicitações de webhook e Connected Content
Este artigo aborda como solucionar problemas de códigos de erro comuns para webhooks e Connected Content e fornece explicações adicionais sobre como esses erros podem ocorrer em suas solicitações.
Erros 4XX
4XX indicam que há um problema com a solicitação enviada ao endpoint. Esses erros geralmente são causados por solicitações errôneas, incluindo parâmetros malformados, cabeçalhos de autenticação ausentes ou URLs incorretos.
Consulte a tabela a seguir para obter detalhes sobre o código de erro e as etapas de resolução:
| Código de erro | O que isso significa | Etapas para resolver |
|---|---|---|
| 400 Solicitação incorreta | Há uma sintaxe inválida na solicitação. |
|
| 401 Não autorizado | A solicitação requer autenticação do usuário. |
|
| 403 Proibido | O ponto de extremidade entende a solicitação, mas se recusa a autorizá-la. |
|
| 404 Não encontrado | O ponto de extremidade não consegue encontrar o recurso solicitado. |
|
| 405 Método não permitido | O método de solicitação é conhecido pelo ponto de extremidade, mas não é compatível com o recurso de direcionamento. |
|
| 408 Tempo limite da solicitação | O ponto de extremidade atingiu o tempo limite de processamento da solicitação. |
|
| 409 Conflito | A solicitação está incompleta devido a um conflito com o estado atual do recurso. |
|
| 429 Solicitações em excesso | Há um número excessivo de solicitações enviadas em um determinado período de tempo. |
|
Erros 5XX
5XX indicam que há um problema com o endpoint. Esses erros geralmente são causados por problemas no lado do servidor.
| Código de erro | O que isso significa |
|---|---|
| Erro interno do servidor 500 | O endpoint encontrou uma condição inesperada que o impediu de concluir a solicitação. |
| 502 Gateway ruim | O ponto de extremidade recebeu uma resposta inválida do servidor upstream. |
| 503 Serviço indisponível | O ponto de extremidade não está conseguindo processar a solicitação devido a uma sobrecarga temporária ou manutenção. |
| 504 Tempo limite do gateway | O ponto de extremidade não recebeu uma resposta oportuna do servidor upstream. |
| 529 Host sobrecarregado | O host do endpoint está sobrecarregado e não pôde responder. |
| 598 Host não saudável | O Braze simulou a resposta porque o host do endpoint está temporariamente marcado como não saudável. Consulte Detecção de host não saudável para saber mais. |
| 599 Erro de conexão | O Braze apresentou um erro de tempo limite de conexão de rede ao tentar estabelecer uma conexão com o endpoint, o que significa que o endpoint pode estar instável ou inativo. |
Resolução de erros 5XX
Aqui estão algumas dicas para solucionar erros comuns do site 5XX:
- Revise a mensagem de erro para obter detalhes específicos disponíveis no registro de atividades de mensagens. Para webhooks, acesse a seção Performance ao longo do tempo na página inicial do Braze e selecione as estatísticas para webhooks. Aqui, você pode encontrar o registro de data e hora que indica quando os erros ocorreram.
- Certifique-se de que não esteja enviando muitas solicitações que sobrecarreguem o endpoint. Você pode enviar em lotes ou ajustar o limite de frequência para verificar se isso reduz os erros.
Detecção de host não saudável
Os webhooks do Braze e o Connected Content empregam um mecanismo de detecção de host insalubre para detectar quando o host de destino apresenta uma alta taxa de lentidão significativa ou sobrecarga, resultando em tempos limite, excesso de solicitações ou outros resultados que impedem que o Braze se comunique com sucesso com o endpoint de destino. Ele atua como uma salvaguarda para reduzir a carga desnecessária que pode estar causando dificuldades ao host de destino. Ele também serve para estabilizar a infraestrutura do Braze e manter velocidades rápidas de envio de mensagens.
Em geral, se o número de falhas exceder 3.000 em qualquer janela de tempo móvel de um minuto (por combinação exclusiva de nome de host e grupo de app - não por jornada de endpoint), o Braze interromperá temporariamente as solicitações ao host de destino por um minuto, simulando respostas com um código de erro 598 para indicar a integridade ruim. Após um minuto, o Braze retomará as solicitações em velocidade máxima se o host for considerado saudável. Se o host ainda não estiver saudável, o Braze aguardará mais um minuto antes de tentar novamente.
Os códigos de erro a seguir contribuem para a contagem de falhas do detector de host não íntegro: 408, 429, 502, 503, 504, 529.
Para webhooks, o Braze repetirá automaticamente as solicitações HTTP que foram interrompidas pelo detector de host não saudável. Essa nova tentativa automática usa backoff exponencial e tentará apenas algumas vezes antes de falhar. Para saber mais sobre erros de webhook, consulte Erros, lógica de repetição e tempos limite.
Para o Connected Content, se as solicitações ao host de destino forem interrompidas pelo detector de host não saudável, o Braze continuará a renderizar mensagens e a seguir sua lógica Liquid como se tivesse recebido um código de resposta de erro. Se você quiser garantir que essas solicitações de Connected Content sejam repetidas quando forem interrompidas pelo detector de host não saudável, use a opção :retry. Para saber mais sobre a opção :retry, consulte Tentativas de Connected Content.
Se achar que a detecção de host não saudável pode estar causando problemas, entre em contato com o suporte da Braze.
Editar esta página no GitHub