메인 콘텐츠로 건너뛰기

레지덴셜 서브계정 설정

API로 자체 트래픽 한도와 목록을 가진 서브 사용자 패키지를 만드세요(리셀러 시나리오).

이 가이드는 자체 트래픽 한도와 목록을 가진 서브 사용자 패키지를 만드는 방법을 설명합니다 — 리셀에 유용합니다.

모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.

1단계 — 서브 사용자 패키지 생성

트래픽 한도, 회전, 만료와 함께 서브 사용자 패키지를 생성하세요. 응답에서 package_key를 복사하세요.

엔드포인트

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/create

요청 본문

이름

유형

설명

traffic_limit

String

바이트 단위 트래픽 한도.

rotation

Number

로테이션: -1 = sticky, 0 = 요청당, 1..3600 = 초.

expired_at

String

패키지 만료일.

is_link_date

Boolean

Boolean — 만료를 메인 패키지에 연동.

응답

{
  "status": "success",
  "data": {
    "package_key": "ab12cd34ef56",
    "rotation": 60,
    "traffic_limit": "1073741824",
    "is_active": true
  },
  "errors": []
}

2단계 — 패키지에 IP 목록 생성

해당 패키지에서 package_key와 geo, export, rotation 설정으로 IP 목록을 생성하세요.

엔드포인트

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/add

요청 본문

이름

유형

설명

package_key

String

패키지 키(패키지 정보에서).

title

String

목록 이름.

geo

object

GEO 데이터베이스의 country, region, city, isp 객체(대소문자 구분).

export

object

객체: ports(IP 수, 최대 1000)와 ext(내보내기 형식).

rotation

Number

로테이션: -1 = sticky, 0 = 요청당, 1..3600 = 초.

응답

{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
    "export": { "ports": 10000, "ext": "txt" }
  },
  "errors": []
}

3단계 — 패키지 확인

서브 사용자 패키지를 조회하여 모두 올바르게 설정되었는지 확인하세요.

엔드포인트

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/packages

응답

{
  "status": "success",
  "data": [
    { "package_key": "ab12cd34ef56", "traffic_limit": "1073741824", "is_active": true, "expired_at": "d.m.Y" }
  ],
  "errors": []
}

전체 API 참조

답변이 도움되었나요?