Subcontas

Uma sub-conta é um rótulo que você adiciona ao seu nome de usuário de proxy para que o tráfego enviado com ele seja contado separadamente. Use uma por cliente, projeto ou equipe para ver quem usou o quê, sem planos ou credenciais separadas.

Sub-contas estão disponíveis nos planos de Proxies Residenciais.

Usando uma sub-conta

Adicione -subaccount-NAME logo após seu nome de usuário. As opções de segmentação e sessão o seguem normalmente:

customer-USERNAME-subaccount-client_a-country-us-sid-abc123-ttl-600:PASSWORD@p.shifter.io:443

curl -x customer-USERNAME-subaccount-client_a:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json

No painel, abra um plano Residencial e vá até Sub-accounts: digite um nome e ele exibe o nome de usuário completo e a linha de proxy, pronta para copiar. O Proxy Generator na mesma página também tem um campo Sub-account para construir endpoints com segmentação e sessões.

Regra	Detalhe
Caracteres	1 a 16 letras, dígitos ou underscores (`A-Z`, `a-z`, `0-9`, `_`). Sem hifens: o hífen separa as opções do nome de usuário
Maiúsculas/minúsculas	Diferencia maiúsculas de minúsculas: `Client_A` e `client_a` são duas sub-contas
Escopo	Por plano: o mesmo nome em dois planos é duas sub-contas separadas
Criação	Nenhuma necessária. Uma sub-conta aparece alguns minutos após sua primeira requisição
Retenção	Listada até 365 dias após sua última requisição. Um nome reutilizado dentro dessa janela continua seu histórico antigo

No painel, a página do plano lista cada sub-conta com seu tráfego de hoje, dos últimos 7 dias e dos últimos 30 dias, e o gráfico de tráfego na página do plano e no painel de controle pode alternar entre a conta principal e qualquer sub-conta.

Autenticação

Ambos os endpoints recebem o api_token da sua conta como parâmetro de consulta, da mesma forma que a Usage & Quota API. Gere-o no painel em Account → API Tokens. Cada um tem limite de taxa de 30 requisições por minuto.

O parâmetro de caminho {membership} aceita o Membership ID exibido na página do plano (por exemplo 68057) ou o código curto da URL do plano (por exemplo Rxqk).

Listar sub-contas

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts

Retorna cada sub-conta observada no plano nos últimos 365 dias, ordenada por nome.

Parâmetro	Em	Obrigatório	Descrição
`membership`	path	sim	Membership ID ou código curto
`api_token`	query	sim	Seu token de API da conta

Exemplo:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts?api_token=YOUR_API_TOKEN"

Resposta:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccounts": ["BigReseller_7", "client_a", "client_b"]
  }
}

Um plano que nunca enviou tráfego de sub-conta retorna uma lista vazia.

Uso de sub-conta em um intervalo de tempo

GET https://shifter.io/api/v1/memberships/{membership}/subaccounts/{subaccount}/usage

Tráfego que uma sub-conta usou entre dois pontos no tempo.

Parâmetro	Em	Obrigatório	Descrição
`membership`	path	sim	Membership ID ou código curto
`subaccount`	path	sim	Nome da sub-conta, com maiúsculas/minúsculas exatas
`api_token`	query	sim	Seu token de API da conta
`start`	query	sim	Início da janela, inclusivo
`end`	query	sim	Fim da janela, exclusivo

start e end aceitam uma data (2026-10-01) ou um timestamp completo (2026-10-01T09:00:00), com no máximo 366 dias de diferença. Os horários são lidos no horário de Paris, o relógio no qual os contadores de tráfego funcionam.

Exemplo:

curl "https://shifter.io/api/v1/memberships/68057/subaccounts/client_a/usage?start=2026-10-01&end=2026-11-01&api_token=YOUR_API_TOKEN"

Resposta:

{
  "error": null,
  "code": 200,
  "data": {
    "id": "Rxqk",
    "subaccount": "client_a",
    "start": "2026-10-01T00:00:00",
    "end": "2026-11-01T00:00:00",
    "granularity": "day",
    "bytes": 412380000000,
    "gb": 412.38,
    "upload_bytes": 18230000000,
    "download_bytes": 394150000000,
    "requests": 9184402
  }
}

Granularidade

O tráfego é contado em blocos, e cada bloco que a janela toca é contado por inteiro:

Janelas que começam dentro dos últimos 7 dias usam blocos por hora ("granularity": "hour").
Janelas mais antigas usam blocos diários ("granularity": "day"), então uma janela a partir de 2026-09-01T15:00:00 conta todo o dia 1 de setembro.

Para números exatos por dia, use dias inteiros como janelas.

Uma sub-conta sem tráfego na janela, ou uma que tenha expirado, retorna zeros.

Erros

Status	Significado
`400`	O plano não é um plano de Proxies Residenciais, o nome da sub-conta é inválido, ou `start`/`end` estão ausentes, fora de ordem, ou com mais de 366 dias de diferença
`401`	`api_token` ausente ou inválido
`403`	O plano está em um workspace ao qual você não pertence
`404`	Plano não encontrado
`429`	Limite de taxa atingido, tente novamente com backoff
`503`	Dados de sub-conta temporariamente indisponíveis, tente novamente com backoff

Começar

Proxies

APIs

Recursos