Destaques
Uma chamada do Auto agora é uma request no seu Dashboard. As tentativas de Single, Proxy Finder e Browser por trás dela continuam lá, listadas por nome sob a chamada, mas sua taxa de sucesso e latência são medidas com base no que você solicitou. Uma recusa pelo seu próprio plano deixou de contar como tráfego, o Auto rotula uma como rate limit, e a página de Billing dá a cada recarga sua própria linha.
O que há de novo
Chamadas do Auto contam como uma request
Uma chamada do Auto costumava aparecer no seu Dashboard como as tentativas realizadas, então um link podia parecer várias requests, algumas delas com falha. Agora Overview, Usage & Limits e Activity trazem o Auto como seu próprio produto. Cada chamada é uma linha com um veredito, e carrega os créditos e bytes de suas tentativas, que ficam sob ela por nome. Seu rate limit continua contando tentativas, já que essas são as requests que os mecanismos realmente executam.
Abra Activity logo após uma chamada e a linha informa que suas tentativas ainda estão em processamento. Alguns segundos depois, ela preenche a lista de tentativas, créditos e bytes no local, sem recarregar a página, para que a linha que você está visualizando não saia do lugar.
Isso corresponde a como o Auto deve ser usado. Ele é um localizador de caminhos: deixe-o encontrar o nível que funciona, depois reproduza o session retornado no /api/single ou /api/browser e direcione seu volume para lá. O Activity agora mostra o que cada chamada tentou antes de você definir uma rota.
Recusas do plano: não são tráfego, e também identificadas no Auto
Uma request recusada por atingir um limite do seu próprio plano não é mais adicionada ao total de tráfego. Nada foi buscado, portanto nada é contabilizado. Um 403 ou um 500 do site ainda conta, porque entregamos essa resposta a você.
Quando uma chamada do Auto atinge um desses limites, o Activity a exibe como Rate Limited em vez de falha, e a resposta traz o mesmo header X-FourA-Limit retornado por uma chamada direta:
import requests
r = requests.post(
"https://api.foura.ai/api/auto",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
limit = r.headers.get("X-FourA-Limit")
if limit:
print("stopped by my plan:", limit)
else:
session = r.json().get("session") # replay on /api/single or /api/browser
Mais uma resposta agora informa o que realmente aconteceu. Um destino cujo hostname não resolve retorna do Single, Browser, Proxy Finder e Auto da mesma forma que qualquer site inacessível: status 0, um erro informando o host e um target outcome (application_fail, consulte outcomes). Destinos em redes privadas ainda recebem a recusa 400.
Tráfego, em uma única unidade
Agora definimos explicitamente o que é um gigabyte: 1.073.741.824 bytes, em cada franquia e contador. O tráfego de API é contabilizado na página decodificada, porque essa página é o que produzimos para você, quer tenha exigido um browser real ou uma etapa extra solicitada pela página. O tráfego da porta de proxy é contabilizado conforme cruza o túnel, onde transportamos sua conexão sem alterar nada dentro dela. Seu Dashboard exibe a definição ao lado dos seus números de tráfego, e Como Seu Plano É Medido traz o método completo.
Os números de tráfego são exibidos em gigabytes sempre que um limite em gigabytes estiver ao lado deles, permitindo comparar diretamente um valor com seu teto. A página Limits ganhou um painel Traffic (total, API, porta de proxy e premium, cada um com uma barra onde seu plano define um teto), a tabela de chaves de API adicionou as colunas Traffic e Premium, e cada painel de produto na Overview mostra seu próprio tráfego.
Além disso, um limite atingido agora exibe um aviso vermelho At limit, já que a próxima request é recusada. Um limite de contagem no teto, como o de chaves de API, é exibido em âmbar: ele apenas impede a próxima adição.
Faturamento: quatro cards e uma linha por recarga
A página Billing mostra os mesmos quatro cards em todos os planos: créditos ou tráfego padrão primeiro (conforme a métrica do seu plano), depois o outro valor, Premium e a porta de Proxy. Cada card possui um botão Buy. Onde seu plano não comercializa esse item, o botão informa isso e oferece uma forma de entrar em contato conosco.
Em um plano pago vendido por créditos, a porta de proxy tem seus próprios gigabytes inclusos, e você pode comprar mais diretamente no card dela. Cada recarga ganha sua própria linha com o que você comprou, o que foi usado e o que resta. O consumo é debitado da recarga que expira primeiro.
Os e-mails de uso também trazem mais detalhes. Aos 95%, você recebe um aviso com o dia em que sua franquia deve acabar no ritmo atual do período, comparado à sua data de renovação, além da ação necessária para aumentá-la. O e-mail de 100% informa quantos dias restam até a renovação e, em planos com excedente, qual é o valor cobrado pelo tráfego adicional.
MCP 0.7.3
O FourA MCP 0.7.3 publica esquemas de ferramentas que validam tanto em JSON Schema draft-07 quanto em 2020-12, permitindo que um cliente com um validador 2020-12 estrito possa listar e chamar todas as quatro ferramentas. Os parâmetros aceitos em uma chamada não mudaram. Atualize o @fouradata/mcp ou use o servidor hospedado, que já executa a versão 0.7.3.
Documentação e o site
- Escolha um resultado na busca dos docs e a página rola até a primeira ocorrência da sua palavra e a destaca. O primeiro resultado é selecionado assim que os resultados aparecem, então Enter já o abre.
- Em celulares e tablets, o menu principal do site abre no momento em que você levanta o dedo e preenche a tela em duas colunas, e cada página renderiza totalmente estilizada em seu primeiro frame.
Sob o capô
A nova capacidade do Proxy Finder agora começa com o que a capacidade existente já aprendeu sobre cada host. Assim, os tempos de resposta permanecem estáveis enquanto ela entra em operação, em vez de se estabilizarem ao longo dos primeiros minutos com o seu tráfego.
Um número no seu Dashboard deve levar você a algo que o seu job fez. Se descobrir de quem era exige uma calculadora e a nossa documentação, é nosso trabalho corrigir o número, não seu decodificá-lo.