이 가이드는 서브 사용자 패키지 업데이트, 목록 관리, 삭제 방법을 설명합니다.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
1단계 — 서브 사용자 패키지 조회
서브 사용자 패키지를 조회하고 작업할 package_key를 복사하세요.
엔드포인트
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": []
}
2단계 — 패키지 업데이트
패키지 업데이트: 트래픽 한도, 회전, 만료를 변경하거나 is_active로 켜기/끄기 하세요.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/update
요청 본문
이름 | 유형 | 설명 |
package_key | String | 패키지 키(패키지 정보에서). |
traffic_limit (선택) | String | 바이트 단위 트래픽 한도. |
rotation (선택) | Number | 로테이션: |
expired_at (선택) | String | 패키지 만료일. |
is_active (선택) | Boolean | Boolean — |
is_link_date (선택) | Boolean | Boolean — 만료를 메인 패키지에 연동. |
응답
{
"status": "success",
"data": {
"package_key": "ab12cd34ef56",
"rotation": 60,
"traffic_limit": "1073741824",
"is_active": true
},
"errors": []
}
3단계 — 패키지 목록 관리
패키지의 목록을 조회한 뒤 목록 이름을 변경(id + title + package_key)하거나 listId로 하나를 삭제하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/lists
응답
{
"status": "success",
"data": [
{ "id": 7788, "title": "Client A", "login": "x1y2z3", "package_key": "ab12cd34ef56" }
],
"errors": []
}
엔드포인트 — rename
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/rename
이름 | 유형 | 설명 |
id | Number | 목록 id. |
title | String | 목록의 새 제목. |
package_key | String | 패키지 키(패키지 정보에서). |
엔드포인트 — delete list
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/delete
4단계 — 또는 전체 패키지 삭제
package_key로 전체 서브 사용자 패키지를 삭제하세요. 되돌릴 수 없습니다.
엔드포인트
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/delete
요청 본문
이름 | 유형 | 설명 |
package_key | String | 패키지 키(패키지 정보에서). |
응답
{
"status": "success",
"data": { "deleted": true },
"errors": []
}