Proxy-seller

서브 계정(서브 유저)

Updated:

주 계정의 인증 정보를 공유하지 않고도 하위 사용자 패키지를 제공하고 목록을 관리하십시오.

A subuser 패키지 이는 귀하의 주요 가정용 요금제에서 분리된 하위 구독 서비스입니다. 귀하는 이 서비스에 데이터 사용량 한도와 유효 기간을 할당하면, 하위 사용자는 그 안에서 자신의 목록을 직접 관리합니다.

이 기능은 재판매자, 팀원 또는 독립된 클라이언트 환경에서 사용하십시오. 하위 패키지에서 소모된 트래픽은 메인 할당량에서 차감되며, 삭제 시 미사용 트래픽은 상위 패키지로 반환됩니다.

서브유저 패키지

하위 패키지 생성, 구성 및 제거

읽기

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 목록

모든 하위 계정 엔드포인트에 공통적으로 적용되는 사항

  1. 기본 URL

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/residentsubuser/
  2. 인증

    URL 경로에 포함된 API 키(서브 유저의 키가 아닌, 본인의 메인 계정 키)

  3. 필수 매개변수

    대부분의 엔드포인트에는 package_key가 필요합니다. 다음에서 확인하십시오.

    GET/ko-KR/residentsubuser/packages
  4. 오류 모델

    비즈니스 오류는 오류[] 필드가 채워진 상태로 HTTP 200을 반환합니다.

관련 항목

Residential proxysame operations on your main packageOpenSession ID + TTLpin sessions for subuser listsOpenCases (FAQ)common subuser scenariosOpen

자주 묻는 질문(FAQ)

아니요 — 이 명칭은 오해를 불러일으킵니다. 이 API에서 “subuser”는 하위 패키지: 별도의 기능을 갖춘 주요 주거용 패키지의 일부 traffic_limit, expired_at, is_active 토글 및 목록.

전체 /residentsubuser/... 엔드포인트는 {YourApiKey} — 사용자 본인. 사양 어디에도 두 번째 API 키가 발급된 내용은 없습니다. 최종 사용자가 받는 인증 정보는 목록 수준입니다. login/password (반환됨: /residentsubuser/list/add) — 이는 프록시 연결 자격 증명이며, 관리 키가 아닙니다.

아니요. 하위 사용자는 자신의 것만 볼 수 있습니다. traffic_limit 그리고 consumed. 메인 계정에서는 두 레이어 모두를 볼 수 있습니다.

호출 update-package 증가된 traffic_limit. 충전 금액은 즉시 반영됩니다.

아니요. 목록은 생성된 하위 패키지에 고정되어 있습니다. 대상 하위 사용자 아래에서 목록을 다시 생성하십시오.

On this page