ARNPROXY
웹사이트로 이동
API v1갱신

자동 갱신 끄기

POST/account/api/v1/auto-renewal/disable
작업을 명시적으로 확인하세요

기록, 잔액 또는 서비스 설정이 변경될 수 있습니다. 범위와 주의 사항을 먼저 읽으세요. 결과가 불확실하면 새 작업을 시작하지 말고 같은 작업을 조회하세요.

권한 인증

AuthorizationBearer YOUR_ARNPROXY_API_KEY
필요한 권한renewals
Acceptapplication/json
Content-Typeapplication/json
Idempotency-Key문자, 숫자, _ 또는 -로 16~100자. 같은 작업에는 저장한 동일 값을 사용하세요.

매개변수

이름유형설명
Idempotency-Key
header필수
string문자/숫자/_/- 16~100자. 작업과 상태 조회에 같은 값을 사용하고 다른 본문에 재사용하지 마세요.
settings
body필수
object[]고유 ID를 가진 본인 잔액 갱신 설정 1~1000개. 카드/PayPal 설정은 관리할 수 없습니다.
settings[].id
body필수
integerauto_renewal_settings의 본인 설정 ID.
settings[].revision
body필수
string해당 설정 행의 64자 revision.
terms
body필수
boolean명시적 승인에는 JSON 불리언 true를 보내야 하며 문자열 "true"는 안 됩니다.

요청 본문

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

request.json
{
    "settings": [
        {
            "id": "YOUR_SETTING_ID",
            "revision": "FROM_SETTINGS_REVISION"
        }
    ],
    "terms": false
}

요청 예제

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

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

응답

200성공 응답
application/json
{
    "ok": true,
    "data": {
        "state": "completed",
        "action": "disable",
        "settings": [
            {
                "id": 20,
                "proxy_id": 12345,
                "order_number": null,
                "active": false,
                "payment_method": "balance",
                "time_id": 101,
                "currency": "TRY",
                "next_renewal_date": "2030-02-01",
                "next_attempt_at": null,
                "last_status": "disabled",
                "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "managed_via_website": false,
                "timezone": "Europe/Istanbul"
            }
        ],
        "payment_method": "balance",
        "configuration_only": true,
        "immediate_charge": false,
        "balance_changed": false,
        "proxy_expiry_changed": false,
        "provider_requests": 0,
        "payment_requests": 0,
        "consent_version": "balance_current_pricing_v1",
        "api_key_revocation_stops_existing_renewals": false,
        "source": "existing_website_auto_renewal",
        "completed_at": "2030-01-01T12:00:00+00:00",
        "replayed": false
    },
    "meta": {
        "request_id": "000000000000000000000001",
        "phase": "public_v1",
        "source": "arnproxy_records"
    }
}
응답 필드 및 유형
이름유형설명
okboolean성공 여부. false이면 error.code를 확인하세요.
dataobject작업별 결과이며 예제는 설명용 합성 데이터입니다.
data.statestring기록/작업 상태. accepted는 배송 완료가 아니며 completed는 연결 테스트가 아닙니다.
data.actionstringaction의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.settingsarraysettings의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.settings[]objectsettings의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.settings[].idinteger관련 ARNPROXY 기록 ID. 공급자 내부 ID 대신 사용하세요.
data.settings[].proxy_idinteger관련 ARNPROXY 기록 ID. 공급자 내부 ID 대신 사용하세요.
data.settings[].order_numberstring|null표시 주문 번호이며 id를 요구하는 필드와 바꿔 쓸 수 없습니다.
data.settings[].activeboolean기록 활성 여부. 비활성 과거 설정도 저장되어 있을 수 있습니다.
data.settings[].payment_methodstring잔액/카드/PayPal 방식. API 설정 관리는 잔액만 지원합니다.
data.settings[].time_idinteger로컬 기간/GB 요금제 ID이며 일수나 GB 수량이 아닙니다.
data.settings[].currencystring계정 거래 통화: TRY 또는 USD.
data.settings[].next_renewal_datestring저장된 갱신일/재시도 시각이며 결제 발생의 증거가 아닙니다.
data.settings[].next_attempt_atstring|null저장된 갱신일/재시도 시각이며 결제 발생의 증거가 아닙니다.
data.settings[].last_statusstringlast status의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.settings[].revisionstring해당 변경/가격 확인에 그대로 반환할 최신성 식별자입니다.
data.settings[].managed_via_websitebooleanmanaged via website의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.settings[].timezonestring관련 날짜 필드의 시간대. null이면 검증된 시간대가 없습니다.
data.payment_methodstring잔액/카드/PayPal 방식. API 설정 관리는 잔액만 지원합니다.
data.configuration_onlybooleanconfiguration only의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.immediate_chargeboolean보고된 작업 효과. 자동 갱신 설정은 향후 별도의 결제를 유발할 수 있습니다.
data.balance_changedboolean보고된 작업 효과. 자동 갱신 설정은 향후 별도의 결제를 유발할 수 있습니다.
data.proxy_expiry_changedboolean보고된 작업 효과. 자동 갱신 설정은 향후 별도의 결제를 유발할 수 있습니다.
data.provider_requestsintegerprovider requests의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.payment_requestsintegerpayment requests의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.consent_versionstringconsent version의 작업별 값입니다. 반환된 유형을 유지하고 동작 설명을 확인하세요.
data.api_key_revocation_stops_existing_renewalsbooleanfalse: 키 폐기는 기존 자동 갱신을 끄지 않습니다. 설정을 따로 꺼야 합니다.
data.sourcestring데이터 출처. 로컬 기록과 실시간 공급자 조회는 서로 다른 근거입니다.
data.completed_atstringAPI가 반환하는 형식의 타임스탬프. 예제 날짜는 합성값입니다.
data.replayedboolean동일 작업의 저장된 결과이며 새 결제/작업의 증거가 아닙니다.
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를 보관하세요. 키나 비밀번호를 보내지 마세요. 오류 및 제한 →

동작 및 주요 참고 사항

  • 기존 잔액 갱신 설정만 관리하며 지금 결제하거나 연장하지 않습니다. 기존 cron이 향후 당시 가격으로 갱신합니다. 키 폐기는 설정을 끄지 않으므로 별도로 비활성화해야 합니다. 카드/PayPal은 사이트에서 관리합니다. 프로모션은 없고 국가별 수량 할인 및 IPv6 전체 주문 선택 조건은 유지됩니다. 시작/완료된 갱신은 되돌릴 수 없습니다.
  • 시간 초과/5xx는 쓰기 실패의 증거가 아닙니다. 원래 Idempotency-Key로 상태를 조회하고 새 키로 재시도하지 마세요. GET은 변경을 재전송하지 않습니다.
  • 만료된 프록시에 연결된 본인 잔액 설정도 끌 수 있습니다. 시작/완료된 갱신이나 결제는 취소되지 않습니다.
동일한 작업 추적설정 작업 확인 →

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