이 가이드는 레지덴셜 패키지가 사용한 트래픽과 비용을 확인하는 방법을 설명합니다.
모든 요청은 계정 대시보드의 개인 API 키를 사용합니다 (API 키 발급 방법). 아래 예시에서 YOUR_API_KEY를 본인의 키로 바꾸세요. 계정 잔액으로 결제하려면 paymentId = 1을 사용하세요.
1단계 — 패키지 정보 가져오기
패키지 상태와 남은 전체 트래픽을 가져오세요. package_key를 복사하세요.
엔드포인트
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
응답
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
2단계 — 트래픽 사용량 가져오기
패키지의 상세 트래픽 사용량을 가져오세요. 목록 로그인 또는 날짜 범위로 필터링할 수 있습니다.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/traffic/details
요청 본문
이름 | 유형 | 설명 |
packageKey | String | 패키지 키(패키지 정보에서). |
login (선택) | String | 선택: 목록 로그인으로 필터링. |
date_start (선택) | String | 선택적 날짜 필터, 형식 DD.MM.YYYY. |
date_end (선택) | String | 선택적 날짜 필터, 형식 DD.MM.YYYY. |
응답
{
"status": "success",
"data": {
"package_key": "1234567890abcdefedcb",
"traffic_usage": "275414777856",
"traffic_usage_formated": "256.5 GB"
},
"errors": []
}
3단계 — 지출 보고서 가져오기
지출 보고서를 가져오세요: 금액, GB당 가격, 목록별 내역.
엔드포인트
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/consumption
요청 본문
이름 | 유형 | 설명 |
login (선택) | String | 선택: 목록 로그인으로 필터링. |
date_start (선택) | String | 선택적 날짜 필터, 형식 DD.MM.YYYY. |
date_end (선택) | String | 선택적 날짜 필터, 형식 DD.MM.YYYY. |
응답
{
"status": "success",
"data": {
"package_key": "1234567890abcdefedcb",
"orders_amount": "$557.99",
"orders_bytes_formated": "256.5 GB",
"price_per_gb": "$2.17"
},
"errors": []
}