ARNPROXY
웹사이트로 이동
API v1Residential 목록 및 트래픽

패키지 스냅샷 갱신

POST/account/api/v1/residential/packages/refresh

권한 인증

AuthorizationBearer YOUR_ARNPROXY_API_KEY
필요한 권한residential_management
Acceptapplication/json
Content-Typeapplication/json

매개변수

이름유형설명
package_id
body필수
integerresidential_packages의 ARNPROXY 패키지 ID이며 공급자의 package_key가 아닙니다.

요청 본문

YOUR_/FROM_을 해당 카탈로그, 견적 또는 범위의 값으로 바꾸세요. 예제의 동의 값은 false입니다. 실제 작업에 동의할 때만 승인하세요.

request.json
{
    "package_id": "YOUR_PACKAGE_ID"
}

요청 예제

cURL
printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" |
  curl --silent --show-error --header @- \
    --header 'Accept: application/json' \
    --connect-timeout 10 --max-time 30 \
    --request POST --header 'Content-Type: application/json' \
    --data-binary @request.json \
    'https://www.arnproxy.com/account/api/v1/residential/packages/refresh'

이 페이지에서는 예제를 실행하지 않습니다. API 키는 서버 환경 변수에 보관하고 URL이나 브라우저 코드에 넣지 마세요. POST 예제에는 request.json을 준비하세요.

응답

200성공 응답
application/json
{
    "ok": true,
    "data": {
        "state": "refreshed",
        "package": {
            "id": 20001,
            "state": "active",
            "snapshot": {
                "source": "arnproxy_records",
                "observed_at": "2030-01-01T12:00:00+00:00",
                "fresh": true,
                "max_age_seconds": 3600,
                "reason": null
            },
            "traffic": {
                "limit_bytes": "10737418240",
                "used_bytes": "1073741824",
                "remaining_bytes": "9663676416"
            },
            "expires_at": "2030-02-01T20:59:59+00:00",
            "rotation_seconds": 0,
            "management_available": false,
            "topup_available": true
        },
        "source": "provider_verified_snapshot",
        "provider_get_requests": 1,
        "provider_write_requests": 0,
        "snapshot_rows_updated": 1,
        "balance_changes": 0,
        "purchases": 0,
        "customer_proxy_expiry_changes": 0
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "provider_verified_snapshot"
    }
}
응답 필드 및 유형
이름유형설명
okboolean성공 여부. false이면 error.code를 확인하세요.
dataobject작업별 결과이며 예제는 설명용 합성 데이터입니다.
data.statestring기록/작업 상태. accepted는 배송 완료가 아니며 completed는 연결 테스트가 아닙니다.
data.packageobjectpackage의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.package.idinteger관련 ARNPROXY 기록 ID. 공급자 내부 ID 대신 사용하세요.
data.package.statestring기록/작업 상태. accepted는 배송 완료가 아니며 completed는 연결 테스트가 아닙니다.
data.package.snapshotobject패키지 관측의 출처/시간/최신성. 오래된 스냅샷은 관리 권한을 주지 않습니다.
data.package.snapshot.sourcestring데이터 출처. 로컬 기록과 실시간 공급자 조회는 서로 다른 근거입니다.
data.package.snapshot.observed_atstringAPI가 반환하는 형식의 타임스탬프. 예제 날짜는 합성값입니다.
data.package.snapshot.freshboolean관측이 최신성 허용 범위에 들어가는지 여부.
data.package.snapshot.max_age_secondsinteger최신 관측으로 인정하는 최대 경과 초.
data.package.snapshot.reasonstring|null고정 사유 코드 또는 null이며 원본 공급자 오류 텍스트가 아닙니다.
data.package.trafficobjecttraffic의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.package.traffic.limit_bytesstring10진수 문자열 바이트 수. JavaScript Number 변환 시 정밀도 손실에 주의하세요.
data.package.traffic.used_bytesstring10진수 문자열 바이트 수. JavaScript Number 변환 시 정밀도 손실에 주의하세요.
data.package.traffic.remaining_bytesstring10진수 문자열 바이트 수. JavaScript Number 변환 시 정밀도 손실에 주의하세요.
data.package.expires_atstringexpires at의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.package.rotation_secondsinteger기록/요청된 회전 초. Rotating 패키지와 Residential 목록의 규칙은 다릅니다.
data.package.management_availableboolean조건/권한에 따른 사용 가능 여부이며 재고나 공급자 보장은 아닙니다.
data.package.topup_availablebooleantopup available의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.sourcestring데이터 출처. 로컬 기록과 실시간 공급자 조회는 서로 다른 근거입니다.
data.provider_get_requestsintegerprovider get requests의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.provider_write_requestsintegerprovider write requests의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.snapshot_rows_updatedintegersnapshot rows updated의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.balance_changesinteger보고된 작업 효과. 자동 갱신 설정은 향후 별도의 결제를 유발할 수 있습니다.
data.purchasesintegerpurchases의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.customer_proxy_expiry_changesintegercustomer proxy expiry changes의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
metaobject요청 추적 및 데이터 출처 메타데이터.
meta.request_idstring이 HTTP 요청의 추적 ID이며 작업 키나 주문 ID가 아닙니다.
meta.phasestringphase의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
meta.sourcestring데이터 출처. 로컬 기록과 실시간 공급자 조회는 서로 다른 근거입니다.

오류 응답

HTTP 401 · INVALID_API_KEY
{
  "ok": false,
  "error": { "code": "INVALID_API_KEY" },
  "meta": { "request_id": "000000000000000000000001" }
}

인증 및 검증 단계에서 실행 전에 요청이 거부될 수 있습니다. 오류 문서를 확인하고 지원 문의용 request_id를 보관하세요. 키나 비밀번호를 보내지 마세요. 오류 및 제한 →

동작 및 주요 참고 사항

  • 패키지와 목록 ID는 ARNPROXY 기록 ID이며 공급자 키가 아닙니다. 오래된 스냅샷은 접근을 허용하지 않습니다. 필요 시 residential_package_refresh를 사용하세요.

현재 언어로 검색합니다. 닫기: Esc