기능 및 범위
이 기능들은 동일한 ARNPROXY 계정과 기존 웹사이트 흐름을 사용합니다. 각 작업 페이지에서 필요한 권한, 지원 제품 및 인증 조건을 확인하세요.
계정 및 잔액
계정, 통화, 잔액 및 유효 권한을 조회합니다. 조건에 맞는 첫 계정 페이지 방문 시 키가 생성되며 관리자 제한과 인증 조건은 유지됩니다.
구매 및 다국가 주문
하나의 product_id에 서로 다른 location_id를 최대 20개 사용할 수 있습니다. 국가별로 별도 주문이 생성되며 연결된 결제는 하나의 청구서로 처리됩니다. 수량 할인은 국가별 수량으로 계산합니다.
접수는 배송 완료가 아닙니다
HTTP 201/202 또는 state=accepted는 접수만 뜻할 수 있습니다. purchase_status / residential_purchase_status로 같은 작업을, order_delivery로 배송을 추적하세요. poll_after_seconds와 Retry-After가 있으면 따르세요. 시간 초과 후 새 Idempotency-Key로 재구매하지 마세요.
다른 관련 작업 · 1
활성 프록시, 메모 및 내보내기
본인의 활성 프록시와 주문 연결만 조회합니다. 메모를 관리하고 필요한 권한으로 접속 정보 또는 CSV·사용자 지정 출력을 받습니다. 다른 고객의 정보는 노출되지 않습니다.
다른 관련 작업 · 3
갱신 및 자동 갱신
갱신 가능한 프록시와 견적을 확인하고 잔액으로 갱신합니다. 자동 갱신 API는 기존 잔액 결제 방식만 관리하며 설정 시 즉시 청구하거나 카드 갱신 설정을 변경하지 않습니다.
IP 교체 요청
비용을 확인하고 요청을 제출한 뒤 상태를 추적합니다. 기존 관리자 검토 절차를 따르며 호출할 때마다 즉시 새 IP가 배정되는 것은 아닙니다.
다른 관련 작업 · 1
기본 로그인과 별도의 추가 로그인
기본 접속 정보를 유지하면서 추가 로그인을 생성·조회·교체·삭제할 수 있습니다. 임의/사용자 지정 모드와 길이 규칙은 options 응답을 따르세요. 일부 작업은 패키지/주문 그룹 전체에 영향을 줍니다. 계정 로그인 페이지에서는 조회와 삭제만 가능하며 생성·교체는 API를 사용합니다.
/extra-logins/replace/options추가 로그인 교체POST /extra-logins/replace로그인 교체 상태GET /extra-logins/replace/status다른 관련 작업 · 9
프록시 허용 IP 관리
범위/options 응답에서 허용한 IP 추가·제거만 사용하세요. 패키지 전체에 적용될 수 있으므로 범위 동의 필드를 생략하지 마세요. 제거는 해당 계정이 API로 추가하고 기록한 IP 권한으로 제한됩니다.
/proxies/{id}/access허용 IP 추가POST /proxies/authorized-ips/add직접 추가한 IP 제거POST /proxies/authorized-ips/remove다른 관련 작업 · 3
- 접근 작업 확인
- 미전송 IP 단계 재개
- 기본 인증 정보 변경 — 비활성 · HTTP 403
Residential: 신규 패키지와 GB 추가의 차이
Residential 주문에서는 고객이 용도를 선택하지 않습니다. 새 패키지는 웹사이트 주문과 같은 고정 용도를 서버가 자동 지정하므로 purpose_id, subpurpose_id 또는 other_purpose를 보내지 마세요. 트래픽 충전은 기존 패키지 용도를 유지합니다.
/residential/catalog패키지 및 충전 견적POST /residential/quote잔액으로 Residential 구매POST /residential/orders/create다른 관련 작업 · 1
위치, IP 풀 및 연결 목록
국가/지역/도시/ISP와 IP 풀 관측값을 조회합니다. 목록 생성, 이름·회전 설정 변경 및 삭제가 가능합니다. 생성 시 지원되는 로그인/비밀번호 또는 IP 인증을 선택하세요. 풀 수치는 캐시된 관측값일 수 있으며 모든 연결의 IP를 보장하지 않습니다.
/residential/locations시간별 트래픽 기록GET /residential/traffic연결 목록 내보내기POST /residential/export다른 관련 작업 · 13
세션 및 대상 지정
먼저 지원되는 전용 Residential 목록을 만들고 검증한 뒤 session/TTL 연결 문자열을 생성합니다. 문자열 생성은 트래픽을 사용하지 않지만 실제 연결은 트래픽을 사용합니다.
/residential/sessions/options별도 세션 목록 생성POST /residential/sessions/create대상 지정 세션 연결POST /residential/sessions/export다른 관련 작업 · 1
Rotating 프록시
지원 Rotating 패키지의 IP 변경 간격을 초 단위로 설정합니다. 즉시 IP를 교체하는 작업이 아니며 설정은 패키지 범위에 적용됩니다.
/rotating/{id}/options회전 간격 변경POST /rotating/rotationRotating 작업 확인GET /rotating/status서로 다른 두 IP 허용 목록
내 계정 → API의 허용 목록은 API 키를 사용할 수 있는 IP를 정하며 계정 페이지에서 관리합니다. 프록시의 허용 IP 설정은 프록시에 접속할 수 있는 주소를 정합니다. 두 설정은 서로 독립적입니다.
Webhook 및 준비된 클라이언트
Webhook은 선택 사항입니다. 자체 HTTPS 수신기에서 서명을 검증하거나 상태 조회로 결과를 추적할 수 있습니다. PHP, Python, Node.js, Java, Go SDK와 Postman 컬렉션을 제공합니다.
제공되지 않는 작업과 주요 제한
카드·은행 결제를 통한 잔액 충전 API는 제공하지 않으며 웹사이트에서 충전해야 합니다. 기본 접속 정보는 고객 API로 변경하거나 삭제할 수 없습니다. IP 교체는 기존 관리자 검토 절차를 따릅니다. Residential 연결 목록 삭제는 GB 패키지를 삭제하지 않습니다.
권한은 관리자의 계정 설정을 따르며 고객이 별도 권한을 선택하지 않습니다. 기존 관리자 제한이 적용됩니다.