초과 사용 설정 변경

PUT/crm-core/v1/plans/me/overage-settings
METERED 차원 초과 사용에 대한 사용자 정책을 변경한다. ALLOW(초과 허용, 종량 과금) / BLOCK(즉시 차단) 중 선택하며, ALLOW 모드에서는 userOverageCapKRW(월간 초과 요금 상한)를 설정해 예산을 제한할 수 있다. 설정은 즉시 적용되며 이후 모든 METERED 사용량 체크에 반영된다. 신규 계정 기본값은 ALLOW, cap = 0(무제한).

Body Params

Name	Type	Required	Description
userOverageMode	string		ALLOW(초과 허용) 또는 BLOCK(차단)
userOverageCapKRW	number		월간 초과 요금 상한 (원). 0 = 무제한. 0 미만 금지

Response

Name	Type	Required	Description
accountPlanId	string		AccountPlan ID
accountId	string		계정 ID
tier	string		현재 티어
userOverageMode	string		업데이트된 모드
userOverageCapKRW	number		업데이트된 상한
currentMonthOverageKRW	number		이번 달 누적 초과 요금 (변경되지 않음)

Structure

코드 예제

const response = await fetch('https://api.solapi.com/crm-core/v1/plans/me/overage-settings', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer ' + TOKEN,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    userOverageMode: 'BLOCK'
  })
});
const plan = await response.json();

import requests
response = requests.put(
    'https://api.solapi.com/crm-core/v1/plans/me/overage-settings',
    headers={'Authorization': f'Bearer {TOKEN}'},
    json={'userOverageMode': 'ALLOW', 'userOverageCapKRW': 100000}
)
plan = response.json()

curl -X PUT 'https://api.solapi.com/crm-core/v1/plans/me/overage-settings' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"userOverageMode":"BLOCK"}'