Destaques
Uma request enviada incorretamente agora resulta em 400 por sua parte, e não em um 503 nosso. Single, Proxy Finder e Browser indicam cada campo com erro, não cobram nada por isso e não induzem mais a uma nova tentativa inviável. A visualização de Budget também separa os créditos que você paga de tudo o que suas requests consumiram, e alterar sua senha agora desconecta todas as outras sessões do Dashboard. Você encontra as duas primeiras novidades no changelog.
Novidades
Uma bad request indica o erro
Envie para o Single, Proxy Finder ou Browser um body que não possa ser processado (um url ausente, um timeout_ms que não seja numérico) e você receberá HTTP 400. O error começa com Invalid request: e lista cada campo com falha junto ao motivo, até o limite de cinco. Trata-se de um resultado client_error e tem custo de 0 créditos.
Até esta semana, essas requests retornavam um 503 genérico, o que parecia uma falha do nosso lado e fazia loops de retry tentarem novamente. Se o seu client trata o 400 como definitivo (como no exemplo da nossa referência de erros), um erro de digitação agora interrompe a execução logo na primeira chamada:
import requests
r = requests.post(
"https://api.foura.ai/api/single",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data", "timeout_ms": "fast"},
)
if r.status_code == 400:
# "Invalid request: timeout_ms: ..." means fix the call, don't retry it
raise ValueError(r.json()["error"])
O Auto funciona como antes aqui. Um campo que ele não pode aceitar ainda retorna como HTTP 200 com status: 400 e o motivo em error, antes de qualquer tentativa e sem custo algum.
Créditos faturados e gastos, lado a lado
A visualização de Orçamento em Métricas agora começa com os créditos faturados, aqueles usados apenas por requests bem-sucedidos, e mostra tudo o que foi gasto logo abaixo como "de N gastos". O custo por request também é em créditos faturados. E o detalhamento por chave, domínio ou IP do cliente tem uma coluna ordenável para cada número.
O gasto conta todos os resultados, porque um request com falha ainda exige uma saída ou um navegador para descobrir que falhou. Portanto, a diferença entre as duas colunas mostra, domínio por domínio, quanto trabalho foi dedicado a requests que não tiveram sucesso.
Fazer logout significa estar desconectado
Altere sua senha em Configurações, redefina-a na página de login ou clique em Desconectar Outros, e todos os outros navegadores conectados à sua conta serão desconectados. Aquele em que você fez a alteração continua ativo. Fazer logout agora encerra essa sessão do nosso lado também, não apenas no seu navegador.
A página de redefinição de senha agora solicita a mesma etapa de verificação do login e cadastro. Ela fica oculta, a menos que precise de você.
Proxy Finder e redirecionamentos de gateway
Algumas saídas ficam atrás de um gateway de rede corporativa. O resumo anterior abordou o tipo que responde com sua própria página de login. O Proxy Finder agora detecta o tipo que responde com um redirecionamento para o serviço de autenticação também, conta isso como uma tentativa com falha e passa para outra saída, em vez de retornar esse redirecionamento como a resposta do site.
Correções menores no Dashboard
- Quando o proprietário selecionado por você (Tudo, Pessoal ou uma organização) ainda não tem chaves de API, a Visão Geral e as Métricas informam isso abaixo do período e indicam a criação de uma.
- Cada número na Visão Geral fica logo abaixo do seu rótulo em um único tamanho, permitindo a leitura direta de uma linha de painéis em qualquer largura. O painel de tentativas do Auto é sempre exibido, marcando zero em períodos sem chamadas do Auto.
- A página de Assinatura remove a opção Mensal/Anual para planos vendidos em apenas uma modalidade.
- Em um período de teste configurado por nós para você, escolher um plano diferente na página de upgrade agora solicita um cartão e inicia um período completo naquele dia. O período de teste termina assim que o pagamento for aprovado.
Nos Bastidores
Chamadas para api.foura.ai e eu.api.foura.ai agora são respondidas por vários servidores ao mesmo tempo em vez de apenas um. Se um parar de responder, as novas chamadas irão para os outros em poucos minutos.
O Auto ficou mais leve. Escolher uma sessão salva para uma chamada agora leva quatro consultas internas, onde antes levava dezenas, e cada servidor executa mais capacidade do Auto do que antes, reduzindo o tempo que as chamadas do Auto passam em fila nos horários de pico.
Cada engine migrou para o runtime com suporte de longo prazo atual com a versão de segurança de outubro, e aplicamos patches em bibliotecas na API, no Dashboard, na documentação e no blog. No Single e no Proxy Finder, o novo runtime mantém uma saída que impede que uma interrupção de leitura no meio de uma request torne lentas as outras requests no mesmo servidor. Antes de um servidor reiniciar para uma nova versão, ele para de receber novas chamadas e volta a operar assim que passa nas verificações.
Retries pertencem aos sites que fazem você esperar, não a um erro de digitação na sua própria request.