서브 계정

서브계정은 프록시 사용자 이름에 추가하는 레이블로, 이를 사용해 전송된 트래픽이 별도로 집계되도록 합니다. 고객, 프로젝트 또는 팀마다 하나씩 사용하면 별도의 플랜이나 자격 증명 없이도 누가 무엇을 사용했는지 확인할 수 있습니다.

서브계정은 Residential Proxies 플랜에서 사용할 수 있습니다.

서브계정 사용하기

사용자 이름 바로 뒤에 -subaccount-NAME을 추가합니다. 타겟팅 및 세션 옵션은 평소처럼 그 뒤에 이어집니다:

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

패널에서 Residential 플랜을 열고 Sub-accounts로 이동하세요: 이름을 입력하면 복사할 준비가 된 전체 사용자 이름과 프록시 문자열이 표시됩니다. 같은 페이지의 Proxy Generator에도 타겟팅과 세션을 포함한 엔드포인트를 만들 수 있는 Sub-account 입력란이 있습니다.

규칙	세부 사항
문자	1~16자의 영문자, 숫자 또는 밑줄(`A-Z`, `a-z`, `0-9`, `_`). 하이픈은 사용할 수 없습니다: 하이픈은 사용자 이름 옵션을 구분하는 데 사용됩니다
대소문자	대소문자를 구분합니다: `Client_A`와 `client_a`는 서로 다른 두 개의 서브계정입니다
범위	플랜 단위: 두 플랜에서 같은 이름을 사용해도 서로 다른 두 개의 서브계정입니다
생성	별도로 생성할 필요가 없습니다. 서브계정은 첫 요청 후 몇 분 내에 나타납니다
보존 기간	마지막 요청으로부터 365일 동안 목록에 표시됩니다. 이 기간 내에 재사용된 이름은 기존 기록을 그대로 이어갑니다

패널에서는 플랜 페이지에 모든 서브계정의 오늘, 최근 7일, 최근 30일 트래픽이 나열되며, 플랜 페이지와 대시보드의 트래픽 차트는 기본 계정과 각 서브계정 사이를 전환할 수 있습니다.

인증

두 엔드포인트 모두 Usage & Quota API와 동일하게 계정의 api_token을 쿼리 매개변수로 받습니다. 패널의 Account → API Tokens에서 생성할 수 있습니다. 각 엔드포인트는 분당 30회 요청으로 속도 제한이 적용됩니다.

{membership} 경로 매개변수는 플랜 페이지에 표시되는 Membership ID(예: 68057) 또는 플랜 URL의 짧은 코드(예: Rxqk)를 허용합니다.

서브계정 목록 조회

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

해당 플랜에서 지난 365일 동안 확인된 모든 서브계정을 이름순으로 정렬하여 반환합니다.

매개변수	위치	필수	설명
`membership`	path	예	Membership ID 또는 짧은 코드
`api_token`	query	예	계정 API 토큰

예시:

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

응답:

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

서브계정 트래픽이 한 번도 발생하지 않은 플랜은 빈 목록을 반환합니다.

기간별 서브계정 사용량

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

두 시점 사이에 한 서브계정이 사용한 트래픽입니다.

매개변수	위치	필수	설명
`membership`	path	예	Membership ID 또는 짧은 코드
`subaccount`	path	예	서브계정 이름, 대소문자 정확히 일치해야 함
`api_token`	query	예	계정 API 토큰
`start`	query	예	기간 시작, 포함
`end`	query	예	기간 종료, 제외

start와 end는 날짜(2026-10-01) 또는 전체 타임스탬프(2026-10-01T09:00:00)를 받으며, 두 값 사이 간격은 최대 366일입니다. 시간은 트래픽 카운터가 기준으로 삼는 파리 시간으로 읽습니다.

예시:

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"

응답:

{
  "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
  }
}

세분화 단위

트래픽은 구간 단위로 집계되며, 해당 기간이 걸쳐 있는 모든 구간은 전체가 집계됩니다:

최근 7일 이내에 시작하는 기간은 시간 단위 구간("granularity": "hour")을 사용합니다.
그보다 이전 기간은 일 단위 구간("granularity": "day")을 사용하므로, 2026-09-01T15:00:00부터 시작하는 기간은 9월 1일 전체를 집계합니다.

정확한 일별 수치를 얻으려면 하루 단위를 온전히 기간으로 사용하세요.

해당 기간에 트래픽이 없는 서브계정이나 이미 만료된 서브계정은 0을 반환합니다.

오류

상태	의미
`400`	플랜이 Residential Proxies 플랜이 아니거나, 서브계정 이름이 유효하지 않거나, `start`/`end`가 누락되었거나 순서가 잘못되었거나 366일을 초과합니다
`401`	`api_token`이 누락되었거나 유효하지 않습니다
`403`	플랜이 사용자가 속하지 않은 워크스페이스에 있습니다
`404`	플랜을 찾을 수 없습니다
`429`	속도 제한에 도달했습니다. 대기 후 다시 시도하세요
`503`	서브계정 데이터를 일시적으로 사용할 수 없습니다. 대기 후 다시 시도하세요

시작하기

프록시

API

리소스