Partilhar via

Tratamento de código de status com Web.Contents

  • Artigo

A Web.Contents função tem algumas funcionalidades internas para lidar com certos códigos de status HTTP. O comportamento padrão pode ser substituído em sua extensão usando o ManualStatusHandling campo no registro de opções.

Repetição automática

Web.Contents repetirá automaticamente as solicitações que falharem com um dos seguintes códigos de status:

Código Status
408 Tempo Limite do Pedido
429 Demasiados pedidos
503 Serviço Indisponível
504 Tempo limite do gateway
509 Limite de largura de banda excedido

As solicitações serão repetidas até três vezes antes de falhar. O mecanismo usa um algoritmo de back-off exponencial para determinar quanto tempo esperar até a próxima nova tentativa, a menos que a resposta contenha um Retry-after cabeçalho. Quando o cabeçalho for encontrado, o mecanismo aguardará o número especificado de segundos antes da próxima nova tentativa. O tempo mínimo de espera suportado é de 0,5 segundos e o valor máximo é de 120 segundos.

Nota

O Retry-after valor deve estar no delta-seconds formato. O HTTP-date formato não é suportado no momento.

Exceções de autenticação

Os códigos de status a seguir resultarão em uma exceção de credenciais, causando um prompt de autenticação solicitando que o usuário forneça credenciais (ou entre novamente no caso de um token OAuth expirado).

Código Status
401 Não autorizado
403 Proibido

Nota

As extensões são capazes de usar a opção com os códigos de status 401 e 403, o ManualStatusHandling que não é algo que pode ser feito em Web.Contents chamadas feitas fora de um conector de dados personalizado (ou seja, diretamente do Power Query).

Redirecionamento

Os códigos de status a seguir resultarão em um redirecionamento automático para o URI especificado no Location cabeçalho. Um cabeçalho ausente Location resultará em um erro.

Código Status
400 Múltiplas escolhas
301 Movido permanentemente
302 Encontrado
303 Ver Outros
307 Redirecionamento temporário

Nota

Somente o código de status 307 manterá um POST método de solicitação. Todos os outros códigos de status de redirecionamento resultarão em uma mudança para GET.