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