이 가이드는 레지덴셜 목록 이름 변경, 회전 변경, 삭제 방법을 설명합니다.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
1단계 — 레지덴셜 목록 조회
레지덴셜 목록을 조회하고 관리할 목록의 id를 복사하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
응답
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}
2단계 — 목록 이름 변경
id와 새 title로 목록 이름을 변경하세요.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rename
요청 본문
이름 | 유형 | 설명 |
id | Number | 목록 id. |
title | String | 목록의 새 제목. |
응답
{
"status": "success",
"data": { "id": 561, "title": "New name" },
"errors": []
}
3단계 — 회전 변경
또는 id로 목록 회전을 변경하세요.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rotation
요청 본문
이름 | 유형 | 설명 |
id | Number | 목록 id. |
rotation | Number | 로테이션: |
응답
{
"status": "success",
"data": { "id": 561, "title": "New name" },
"errors": []
}
4단계 — 또는 목록 삭제
id로 목록을 삭제하세요. 되돌릴 수 없습니다.
엔드포인트
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/delete
요청 본문
이름 | 유형 | 설명 |
id | Number | 목록 id. |
응답
{
"status": "success",
"data": { "deleted": true },
"errors": []
}