하위 계정(하위 사용자)
Updated:
주 계정 자격 증명을 공유하지 않고도 서브 사용자 패키지를 제공하고 해당 목록을 관리할 수 있습니다.
A 서브유저 패키지 이는 귀하의 주요 주거용 요금제에서 분리된 하위 요금제입니다. 사용자는 이 요금제에 데이터 사용량 한도와 유효 기간을 할당하면, 하위 사용자는 그 안에서 자신의 목록을 직접 관리할 수 있습니다.
이 기능은 리셀러, 팀 구성원 또는 독립된 고객 환경에 사용하십시오. 하위 패키지에서 사용된 트래픽은 메인 할당량에서 차감되며, 삭제 시 미사용 트래픽은 상위 패키지로 반환됩니다.
서브유저 패키지
하위 패키지 생성, 구성 및 제거
읽기
GET/residentsubuser/packages
패키지 정보 확인하기
트래픽 제한, 유효기간 및 패키지 키가 설정된 모든 하위 사용자 패키지.
쓰기
POST/residentsubuser/create
하위 사용자 패키지 생성
주 요금제에서 새로운 하위 패키지를 위해 트래픽과 유효 기간을 할당하십시오.
POST/residentsubuser/update
패키지 업데이트
트래픽 할당, 순환 또는 유효 기간을 조정하세요. 사용되지 않은 트래픽은 서브패키지에 남아 있습니다.
DELETE/residentsubuser/delete
하위 사용자의 패키지 삭제
서브패키지를 해지하세요. 사용하지 않은 데이터는 기본 요금제로 이월됩니다.
subuser 패키지의 리스트
상위 주거용 목록과 동일한 기능을 제공하며, 하위 패키지로 범위가 제한됨
읽기
GET/residentsubuser/lists
기존 IP 목록 가져오기
서브패키지 내의 모든 목록입니다. `package_key` 또는 `listId`로 필터링할 수 있습니다.
쓰기
POST/residentsubuser/list/add
IP 목록 생성
GEO 필터와 인증 방식을 사용하는 서브패키지에 목록을 추가합니다.
POST/residentsubuser/list/rename
생성된 목록의 이름 변경
서브패키지 내에서 목록의 표시 이름을 변경합니다.
POST/residentsubuser/list/rotation
회전 방향 변경
고정, 요청별 또는 시간 기반(1~3600초) 로테이션을 설정합니다.
DELETE/residentsubuser/list/delete
목록 삭제
서브패키지에서 목록을 제거합니다. 활성 연결은 약 60초 이내에 끊어집니다.
특집: API-TOOL 목록
모든 하위 계정 엔드포인트에 공통적으로 적용되는 사항
기본 URL
https://proxy-seller.com/personal/api/v1/{YourApiKey}/residentsubuser/인증
URL 경로에 포함된 API 키 (서브 사용자의 키가 아닌, 귀하의 메인 계정 키)
필수 매개변수
대부분의 엔드포인트에서는 package_key가 필요합니다. 다음에서 확인하세요.
GET/ko-KR/residentsubuser/packages오류 모델
비즈니스 오류는 errors[]가 채워진 상태로 HTTP 200을 반환합니다.