Destaques
Foi o site que recusou ou o seu plano? Cada request que o seu plano recusa agora responde em um header, e o Auto e o Playground também leem essa resposta. A porta proxy agora memoriza o direcionamento na chave, e a renderização via Browser, incluindo páginas interativas, vem em todos os planos, inclusive no Free.
Novidades
Uma recusa que identifica quem recusou
Quando um dos limites do seu plano rejeita uma request, a response traz um header X-FourA-Limit informando qual deles: plan_limit_credits, plan_limit_rate, plan_limit_browser_daily e outros quatro. O body repete o código em reason, ao lado do limite aplicado à sua conta. Os limites compartilhados da nossa plataforma nunca definem esse header, portanto a presença dele por si só indica que a recusa é da sua conta, e não porque o FourA está sobrecarregado.
import requests
r = requests.post(
"https://api.foura.ai/api/single",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
limit = r.headers.get("X-FourA-Limit")
if limit:
print("my plan stopped this:", limit, r.json()["error"])
Cada limite da sua conta agora vem do plano contratado, e a seção Uso e Limites lista cada um ao lado do seu status no período atual. A referência de rate limits contém todos os sete códigos e explica quais deles são liberados após uma breve espera.
O Auto lê o mesmo código e age com base nele. Um limite que bloqueia um nível específico (como o limite diário de sessões de browser) mantém o restante da cadeia operacional, e os pontos de saída já testados não são penalizados por uma recusa gerada pelo seu plano. Um limite que indica o esgotamento da própria conta, como créditos, largura de banda ou um recurso ausente no seu plano, interrompe a cadeia imediatamente e retorna a recusa, sem tentar todas as outras rotas antes. Nada disso altera o propósito do Auto: deixe que ele encontre o nível que funciona, replique a sessão retornada no /api/single ou /api/browser e direcione seu volume principal para lá.
O Playground detalha isso de forma explícita. Uma linha acima da response informa o que processou a página: uma sessão já existente para aquele host, uma request simples, um proxy rotativo ou um browser real, além de indicar se um desafio foi resolvido, qual tentativa teve sucesso e o custo gerado. Quando o seu plano interrompe a request, a linha começa com "Interrompido pelo seu plano, não pelo site" e especifica o limite.
A porta de proxy, em beta
A porta de proxy permite que qualquer cliente compatível com URL de proxy envie tráfego através dos nossos nós de saída, sem a necessidade de chamadas de API. Trata-se de uma versão beta: o tráfego que passa por ela ainda não é faturado, não possui garantia de uptime (SLA) e os nomes das opções ainda podem mudar.
Esta semana ficou mais claro o que você está selecionando: a rede compartilhada, que utiliza nossas próprias saídas e já está inclusa no seu plano, ou a rede residencial, com endereços residenciais deduzidos do tráfego premium do seu plano. O fallback para a rede residencial quando a compartilhada falha ao processar uma request é uma opção separada e começa desmarcada. Marcar essa caixa por padrão significaria decidir gastar sua cota sem sua autorização.
O direcionamento agora reside nas credenciais. Configure um país, região, cidade ou dispositivo em um usuário de proxy e todas as conexões estabelecidas com ele seguirão essa regra. Dessa forma, a string de conexão é reduzida apenas às credenciais essenciais e às variações necessárias. O username ainda tem prioridade para aquela conexão específica, e any anula um valor salvo: -city-any solicita o país inteiro a partir de uma chave configurada para uma cidade específica.
Executando um perfil de browser por endereço? Defina quantos endereços fixos (sticky) você precisa e a página exibirá uma linha para cada um, com seu respectivo nome de sessão. A opção de novos nomes gera uma lista atualizada quando um alvo bloqueia a anterior, e as linhas são disponibilizadas como URL ou como host:port:user:pass, o formato compatível com a maioria dos gerenciadores de proxy. A documentação da porta de proxy contém toda a estrutura de parâmetros do username.
Páginas protegidas, em todos os planos
A renderização de navegador e páginas interativas fazem parte de todos os planos, incluindo o Free, e apenas os limites variam. Os planos Free e Developer também incluem um pouco de tráfego de saída premium, para que você possa ver uma página protegida responder na sua própria URL antes de pagar qualquer coisa.
As saídas premium no Proxy Finder não dependem mais de qual site você aponta. Envie exitClass: premium para qualquer destino e o tráfego premium do seu plano (e o saldo restante dele) é o único fator determinante.
Faturamento que segue seus dados
A empresa, o número de identificação fiscal e o país que você salva em Billing Details são o que emitimos na sua fatura e o que define a tributação, no checkout e em cada renovação. Se você preencher algo diferente no formulário de pagamento, isso substitui apenas aquele campo para aquele pagamento específico.
Se configuramos um plano para você como parte de um contrato assinado, a seção Plan & Usage agora o exibe com um botão Confirm: escolha mensal ou anual, adicione um cartão e pague o período completo antecipadamente, sem valores proporcionais.
Dois novos cartões aparecem ao lado de créditos em Plan & Usage, um para largura de banda e outro para tráfego premium, mostrando o consumo em relação ao que o seu plano inclui mais as recargas adquiridas. Quando uma recarga desse tipo estiver disponível para compra, o botão Buy estará no cartão correspondente. O guia de faturamento explica ambos em detalhes.
Por baixo do capô
Seu rate limit por minuto contabiliza com precisão o tráfego enviado naquele minuto, até o início do próximo. As tabelas do painel se ajustam à tela de um laptop e, no celular, as tabelas largas rolam lateralmente dentro da própria moldura. As tabelas do blog rolam da mesma forma em telas estreitas. E a página da sua organização lista os convites pendentes assim que é aberta.
Uma resposta de recusa clara permite planejar melhor. Na próxima vez que uma tarefa parar, um único header informará se você deve esperar um segundo, aguardar a meia-noite UTC ou verificar seu plano.