Hoje estamos lançando duas coisas que andam juntas. Sub-accounts permitem rastrear o tráfego por cliente, projeto ou equipe em um único plano de Residential Proxies, direto a partir do username do proxy. E o Shifter Reseller Program dá a empresas de proxy acesso no atacado à nossa rede, com sub-accounts como a forma de ver o que cada um dos clientes delas usa.
Se você está com pressa: adicione -subaccount-NAME logo após seu username, envie uma requisição, e essa sub-account aparece no seu painel alguns minutos depois com seu próprio tráfego. Se você vende proxies, o reseller program é o ponto de partida.
Por que criamos isso
A pergunta que mais ouvimos de agências, equipes de SaaS e revendedores de proxy é alguma variação de “quem usou o quê”. Um plano frequentemente atende vários clientes: uma agência rodando coleta de dados para uma dúzia de marcas, um produto de scraping que empacota proxies dentro da própria assinatura, um revendedor com centenas de usuários finais. Até agora a única resposta era um plano por cliente, o que é pesado de gerenciar e ainda assim não diz nada sobre os clientes que compartilham um plano.
Sub-accounts respondem a isso sem novos logins, novos planos ou chamadas de configuração. O rótulo viaja junto com o tráfego, então a atribuição acontece onde as requisições são feitas.
Como funciona uma sub-account
Uma sub-account é um rótulo no seu username de proxy. Ela vem logo após seu username, e toda opção de targeting e sessão segue normalmente depois dela:
customer-USERNAME-subaccount-client_a-country-us-sid-abc123-ttl-600:PASSWORD@p.shifter.io:443
Não há nada para criar com antecedência. Uma sub-account existe a partir da primeira requisição, e permanece listada até 365 dias após a última. Algumas regras:
- Os nomes têm de 1 a 16 letras, dígitos ou underscores. Sem hífens, porque o hífen separa as opções no username.
- Os nomes diferenciam maiúsculas de minúsculas:
Client_Aeclient_asão duas sub-accounts diferentes. - Sub-accounts pertencem a um plano. O mesmo nome em dois planos são duas sub-accounts separadas.
Sub-accounts funcionam em todos os planos de Residential Proxies.
Onde você as encontra
Abra um plano Residential no painel e você vai encontrar uma nova seção Sub-accounts:
- Criar uma sub-account. Digite um nome e o painel mostra o username completo e a linha de proxy completa, pronta para copiar e entregar a quem precisar.
- Uma tabela com todas as sub-accounts do plano, com seu tráfego de hoje, dos últimos 7 dias e dos últimos 30 dias. Listas grandes são pesquisáveis e paginadas.
- View chart em qualquer linha alterna o gráfico de tráfego do plano para aquela sub-account.
O gráfico de tráfego no dashboard e em cada página de plano também tem um novo seletor, para que você alterne entre a conta principal e qualquer sub-account e leia seu histórico por dia, semana, mês ou um intervalo personalizado. O Proxy Generator também ganhou um campo Sub-account, para montar endpoints já com targeting e sessões configurados.
Sub-accounts na API
Dois novos endpoints expõem os mesmos dados, usando o api_token que você já usa para a Usage & Quota API:
GET /api/v1/memberships/{membership}/subaccountslista todas as sub-accounts vistas em um plano.GET /api/v1/memberships/{membership}/subaccounts/{name}/usage?start=&end=retorna o tráfego de uma sub-account para qualquer janela de tempo, em bytes e GB, com contagem de requisições.
Alimente-os no seu próprio sistema de faturamento, dashboards de clientes ou alertas. A referência completa, com exemplos e códigos de erro, está nos docs de sub-accounts.
O que sub-accounts não são
Vale ser preciso aqui, porque “sub-account” significa coisas diferentes em ferramentas diferentes.
- Elas compartilham o plano. Toda sub-account usa a senha do seu plano e consome a banda do seu plano. Não há login ou cota separada por sub-account.
- Elas servem para rastreamento. Não impomos limites por sub-account. Se você revende acesso, sua própria plataforma decide o que cada cliente pode usar, e nossos números dizem a ela o que foi efetivamente usado.
- Elas não substituem workspaces. Quando um cliente precisa de seu próprio faturamento, carteira e equipe, um workspace separado ainda é a ferramenta certa. Explicamos como as duas coisas se encaixam no nosso guia sobre rastreamento de uso para múltiplos clientes.
O Shifter Reseller Program
Sub-accounts são a peça que os revendedores vinham pedindo, então estamos abrindo um reseller program junto com elas.
O modelo é simples. Você compra banda residencial no atacado, com preços construídos em torno do seu volume mensal esperado e do prazo de compromisso assumido. Você administra a vitrine: cadastro, preços, limites e faturamento ficam na sua plataforma. Cada um dos seus clientes recebe uma sub-account, e nossa usage API fornece à sua plataforma os números de tráfego para impor limites e faturar. Nós administramos a rede: um dos maiores pools residenciais ao vivo, com targeting por país, região, cidade e ASN e uma ampla variedade de ISPs.
Você pode construir e testar sua integração em qualquer plano Residential hoje e migrar para condições de revenda conforme seu volume cresce. Para se inscrever, abra a página do reseller program e nos envie seu tráfego mensal esperado, seu prazo de compromisso e para que seus clientes usam proxies. Nós respondemos com suas condições.
Alguns padrões que isso viabiliza
- Agências rotulam os jobs de cada cliente com o nome desse cliente e reportam o uso por cliente a partir de um único plano, sem dividir orçamentos entre vários planos.
- Plataformas de scraping e dados dão a cada cliente final uma sub-account e faturam com base no consumo real em vez de estimativas.
- Equipes internas rotulam o tráfego por projeto ou serviço, de modo que um job fora de controle é fácil de identificar quando o uso dispara.
Onde encontrar
Sub-accounts já estão disponíveis em todos os planos de Residential Proxies. Abra um plano no painel e procure a seção Sub-accounts, ou comece pelos docs se estiver integrando isso ao seu código. Se você vende proxies, a página do reseller program tem tudo que você precisa para se inscrever.
Assim como com os Team Workspaces, mantivemos a superfície pequena de propósito para continuarmos melhorando. Se houver um relatório ou um endpoint que sua plataforma precise, nos avise.