개발자용 API
프록시 구매와 관리를 직접 작성한 코드에서 할 수 있습니다: 주문하고, 패키지를 조회하고, 연장하고,
이벤트를 추적합니다. 구매한 모든 것은 패키지가 됩니다.
패키지는 두 종류이며 family 필드로 구분합니다:
| Residential | IPv4 | |
|---|---|---|
family | traffic_gateway | dedicated |
| 구매 대상 | 기가바이트 단위의 트래픽 용량 | 기간제 전용 주소 N개 |
| 결제 기준 | 기가바이트, 트래픽은 소멸되지 않음 | 주소당 기간: 1주, 2주, 1개월, 2개월 또는 3개월 |
| 연결 | 원하는 지역으로 원하는 만큼 연결 문자열 생성 | 하나의 로그인과 비밀번호를 쓰는 고정된 주소 목록 |
| IP 변경 | 로테이션 또는 IP 변경 링크 | 30일에 한 번 패키지의 모든 주소 교체 |
| 상품 | Residential | IPv4 |
구매, 패키지 목록, 패키지 카드는 두 종류 공통 라우트입니다. 한 종류에만 있는 작업은 따로 설명합니다: 트래픽과 고정 주소.
기본 URL과 인증
섹션 제목: “기본 URL과 인증”https://ipv.rentcurl https://ipv.rent/api/v1/balance \ -H 'Authorization: Bearer YOUR_API_KEY'가입은 app.ipv.rent에서 하고, 가입 후 이메일을 인증하세요. 인증 전에는 로그인할 수 없습니다.
키는 대시보드에서 발급합니다: 프로필 → API 키 → 키 만들기. 비밀 값은 한 번만 표시되며, 계정당 활성 키는 최대 20개입니다.
폐기된 키는 즉시 거부되고, 이벤트 로그에 api_key.revoked 이벤트가 기록됩니다.
401 invalid_api_key - 키가 거부되었습니다. 403 insufficient_scope - 키에 라우트가 요구하는
권한이 없습니다.
모든 필드와 예시가 포함된 요청 및 응답 스키마는 OpenAPI 레퍼런스에 있습니다.
키 권한
섹션 제목: “키 권한”권한을 지정하지 않고 발급한 키는 모든 권한을 받습니다. 발급된 키의 권한은 바꿀 수 없습니다.
| 권한 | 허용하는 것 |
|---|---|
catalog:read | 상품과 옵션, 지역 카탈로그, 가격 계산 |
packages:read | 패키지 목록, 패키지 카드, 연장 옵션 |
packages:write | 구매와 패키지의 모든 작업: 트래픽 추가, 연결, 비밀번호, 연장, 주소 교체, 지문, 자동 갱신 |
orders:read | 주문 |
orders:write | 예약됨 - 현재 이 권한을 요구하는 라우트는 없음 |
billing:read | 잔액과 거래 |
events:read | 이벤트 로그 |
라우트
섹션 제목: “라우트”카탈로그와 구매 - 두 종류 공통:
| 라우트 | 권한 | Idempotency-Key |
|---|---|---|
GET /api/v1/products | catalog:read | - |
GET /api/v1/products/{product}/options | catalog:read | - |
POST /api/v1/quote | catalog:read | 아니요 |
POST /api/v1/packages | packages:write | 필수 |
GET /api/v1/packages | packages:read | - |
GET /api/v1/packages/{id} | packages:read | - |
POST /api/v1/packages/{id}/password | packages:write | 아니요 |
Residential 전용:
| 라우트 | 권한 | Idempotency-Key |
|---|---|---|
GET /api/v1/geo/countries, /states, /cities, /asns | catalog:read | - |
POST /api/v1/packages/{id}/proxies | packages:write | 아니요 |
POST /api/v1/packages/{id}/topup | packages:write | 필수 |
POST /api/v1/packages/{id}/rotation-secret | packages:write | 아니요 |
IPv4 전용:
| 라우트 | 권한 | Idempotency-Key |
|---|---|---|
GET /api/v1/packages/{id}/prolong-options | packages:read | - |
POST /api/v1/packages/{id}/prolong | packages:write | 필수 |
POST /api/v1/packages/{id}/replace | packages:write | 아니요 |
POST /api/v1/packages/{id}/fingerprint | packages:write | 아니요 |
POST /api/v1/packages/{id}/renewal | packages:write | 아니요 |
계정:
| 라우트 | 권한 | Idempotency-Key |
|---|---|---|
GET /api/v1/orders, /orders/{id} | orders:read | - |
GET /api/v1/balance, /transactions | billing:read | - |
GET /api/v1/events | events:read | - |
다른 종류의 작업을 패키지에 요청하면 422 unsupported_capability로 응답합니다.
잔액 충전과 키 관리는 대시보드에서만 가능합니다.
요청 제한
섹션 제목: “요청 제한”키당 분당 120회, 여기에 무언가를 변경하는 요청(POST)은 별도로 분당 30회입니다. 모든 응답에
RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset이 포함됩니다. 초과하면 429와 함께
retry_after와 Retry-After가 옵니다: 지정된 초만큼 기다린 뒤 다시 시도하세요.
Telegram: @ipvrent_support, 이메일
[email protected]. 오류 응답 본문의 request_id를 첨부하세요.
뉴스와 서비스 상태는 t.me/ipvrent 채널에서 확인하세요.