Como Seu Plano É Medido
A FourA vende dois produtos, e eles são medidos em unidades diferentes. O seu plano é vendido em uma dessas duas unidades, o que determina qual limite recusa você e quais cartões você vê no painel. Esta página apresenta o modelo completo em uma única tela.
Dois produtos, duas unidades
| Produto | O que você chama | A unidade |
|---|---|---|
| API | POST /api/single, /api/proxy, /api/browser, /api/auto |
Uma request, precificada em créditos |
| Porta de proxy | proxy.foura.ai:34004 de qualquer cliente que aceite uma URL de proxy |
Um túnel, precificado em gigabytes |
Na API, apenas um resultado success consome créditos. Uma request que falhou no lado do destino, no seu lado ou no nosso não custa nada para você. O tráfego premium é contabilizado separadamente dos créditos, conforme descrito abaixo. Consulte Request Outcomes.
Na porta de proxy não há créditos nem contagem de requests, e isso não é uma omissão. Um túnel é uma conexão que sua ferramenta abre, e o que ela envia por dentro é o seu próprio tráfego criptografado, portanto a FourA pode contabilizar o túnel e os bytes transmitidos, mas nada além disso. Uma contagem de requests aqui seria um número impossível de reconciliar com os seus próprios logs. Por isso, a porta é sempre vendida por gigabyte. Consulte Proxy Port.
O que é um gigabyte e o que está incluído
Um gigabyte significa 1.073.741.824 bytes (2^30, a unidade também escrita como GiB). Cada franquia, contador e preço no seu plano usa esse valor, tanto na API quanto na porta de proxy.
O que é contabilizado varia de acordo com o produto, pois os dois transportam dados diferentes:
| Onde | O que é contabilizado |
|---|---|
| API, saídas padrão | O body da request que você nos envia, mais o body da response que retornamos. Os headers HTTP não são contabilizados, em nenhum dos lados. |
| API, saídas premium | Cada byte da transferência conforme atravessou a rede, em ambas as direções, comprimido e criptografado durante o trajeto. |
| Porta de proxy | Cada byte que atravessa o túnel, em ambas as direções, após ser aberto, incluindo a configuração da conexão criptografada que o seu cliente realiza com o site. A abertura do túnel não é contabilizada, exceto que uma saída premium que a porta tenta e não usa ao abrir o seu túnel conta como tráfego premium. |
Algumas consequências que vale a pena saber:
- A página é contabilizada decodificada, porque a página decodificada é o que produzimos. Chegar até ela pode significar executar um navegador real, concluir uma etapa extra solicitada pela página, depois decodificar a response e entregar a você um conteúdo que possa usar. O que você paga é por esse resultado, não pela compactação com que ele foi transmitido. A porta de proxy é o outro caso e é tarifada de forma oposta: nela, transportamos a sua própria conexão e não alteramos o conteúdo dentro dela, portanto contabilizamos os bytes exatamente como eles atravessam o túnel.
- Tentativas adicionais (retries) no pool padrão não custam nada para você. Quando o Proxy Finder alterna entre várias saídas, você paga uma única vez, pela resposta recebida, não importando quantas saídas foram tentadas. Em uma saída premium, cada tentativa conta, pois é assim que as redes premium nos cobram.
- Uma sessão de navegador em uma saída padrão é contabilizada como qualquer outra response da API: o body que retornamos a você, e não todos os sub-recursos carregados pela página. Por meio de uma saída premium, a sessão inteira trafega na rede e é contabilizada lá.
- O tráfego Premium faz parte do seu total, não é uma adição a ele. Sua franquia padrão é cobrada apenas pela parte que não passou por uma saída premium.
- Uma chamada Auto não gera tráfego próprio. As requests Single, Proxy Finder e Browser que ela realiza são contabilizadas como se você mesmo as tivesse feito.
- Uma recusa por parte do site é contabilizada; uma recusa pelo seu próprio plano não é. Quando um site responde 403, 404, 429 ou 5xx, nós transportamos essa resposta até você, portanto ela conta. Quando um limite do seu próprio plano recusa a request, nada é buscado e nada é contabilizado.
- Nada é arredondado para cima. Os bytes são contabilizados com precisão, sem tamanho de bloco e sem mínimo por request, e seus números são reconciliados todas as noites com nosso armazenamento de métricas.
Duas maneiras pelas quais um plano é comercializado
Ambos os medidores funcionam para todas as contas. O que muda é a métrica sob a qual seu plano é comercializado.
Comercializado por créditos
A API cobra créditos por request faturada. A porta de proxy recebe seus próprios gigabytes inclusos, cotados separadamente, pois um túnel não tem uma request para a qual cobrar um crédito. Os dois não interferem entre si: o tráfego da sua API não consome os gigabytes da porta, e os túneis da porta não consomem seus créditos. A alternativa seria cobrar uma única request da API duas vezes: uma em créditos e outra nos bytes que esses créditos geraram.
O limite de tráfego próprio da API fica desativado, a menos que seu plano inclua um.
Comercializado por tráfego
Uma franquia de tráfego padrão cobre a API e a porta de proxy conjuntamente, pois ambos os pontos de entrada são precificados na mesma unidade. Um plano vendido dessa forma não fatura créditos, portanto os créditos desaparecem do painel completamente em vez de exibir um número sem significado.
Tráfego premium, em ambos
O tráfego premium sempre tem sua própria franquia, em qualquer tipo de plano. Ele nunca é contabilizado dentro do valor padrão, portanto um gigabyte nunca é debitado em dois limites simultâneos. Você acessa uma saída premium com exitClass: premium no POST /api/proxy/ ou -network-premium na porta de proxy.
É medido conforme cruza a rede: em ambas as direções, compactado e criptografado durante o trajeto. Na API, toda tentativa premium conta, incluindo aquela que não retornou sua página; na porta do proxy, é o tráfego de cada túnel premium, mais qualquer saída premium que a porta tentou e descartou ao abri-lo.
O que recusa você e onde
| Franquia | Na API | Na porta do proxy |
|---|---|---|
| Créditos para o período | 429 com X-FourA-Limit: plan_limit_credits |
Não aplicável |
| Tráfego padrão para o período | 429 com X-FourA-Limit: plan_limit_bandwidth |
429 com X-Foura-Error nomeando o tráfego |
| Túneis abertos simultaneamente | Não aplicável | 429 com X-Foura-Error |
| Aberturas de túnel por minuto | Não aplicável | 429 com X-Foura-Error |
| Tráfego premium | Rebaixado, não recusado | 403 em uma requisição explícita |
Um CONNECT não tem corpo para incluir um erro JSON, e é por isso que uma recusa de porta é um status acompanhado de um header, em vez do formato descrito em Rate Limits. Leia X-Foura-Error antes de qualquer outra coisa em uma conexão de proxy.
O término do premium é a única assimetria
As duas portas respondem deliberadamente de forma diferente, porque "eu pedi para gastar" e "algo foi configurado para mim anteriormente" são situações distintas.
Na API, uma franquia premium esgotada nunca interrompe um trabalho. A requisição é atendida pelo pool padrão e a resposta indica exitClass: standard, para que você possa ver o que realmente recebeu. Um plano que não inclui saídas premium tem uma resposta diferente: trata-se de um 403 com plan_limit_premium.
Na porta do proxy:
- Uma conexão que especifica
-network-premiumé recusada com um403. Você pediu para gastar, portanto, ser atendido silenciosamente por outro lugar deixaria você tentando reconciliar uma linha premium que nunca aparece. - Um padrão premium salvo no usuário do proxy é rebaixado para a rede compartilhada, e o túnel ainda abre. Você não o escolheu para esta conexão.
- Um
-fallback-premiumarmado simplesmente não é acionado.
Comprando mais
Recargas contam exatamente da mesma forma que o incluído no plano. A cada período, a franquia do seu próprio plano é usada primeiro, e apenas o excedente consome o saldo comprado. Uma compra dura doze meses.
O painel mantém os dois números separados sempre que cita uma franquia (75,000 (50,000 incl + 25,000 bought)), para que o valor na tela possa ser reconciliado com a fatura que você possui.
Onde consultar seus próprios números
| Página | O que responde |
|---|---|
| Billing | Este período em relação ao disponível, um cartão por item medido pelo seu plano, com um botão Comprar em cada |
| Usage & Limits | Cada limite ao lado do seu contador em tempo real, além de um detalhamento por chave, por endpoint e por usuário de proxy |
| Overview | Volume e tráfego em qualquer período, por produto |
Quais cartões a seção Billing exibe depende dos dois casos acima: um plano vendido por créditos recebe um cartão Credits e um cartão de tráfego Proxy port; um plano vendido por tráfego não recebe nenhum dos dois, e seu cartão Standard traffic contém o limite e informa The API and the proxy port together.
Não defina nenhum desses números no código de forma fixa. Toda recusa de API traz o teto que a recusou, e toda recusa de porta o indica no X-Foura-Error.
Relacionados
- Rate Limits: Todos os corpos e headers de limite de plano na API
- Proxy Port: Medição, response codes e opções de username
- Request Outcomes: Quais resultados são cobrados, para requests e túneis
- Billing & Subscriptions: Planos, recargas e faturas
- Usage & Limits: Seus contadores em tempo real em relação ao seu plano