티어 표

티어 진입 기준과 한도 표를 돌려줍니다

GET /v1/tiers

인증

방식	허용	조건
API 키 (`Authorization: Bearer xci_live_…`)	가능	키 권한 `read` (run 키도 가능)
콘솔 세션 쿠키	가능	조직 역할 `owner`, `admin`, `developer`

응답

200

필드	타입	항상	설명
`data`	array<object>	항상	항목 배열
`data[].tier`	integer	항상	티어 번호, 1부터, 최소 1
`data[].name`	string		티어 이름
`data[].min_cumulative_topup_micro_usd`	integer	항상	진입 누적 충전액, 최소 0
`data[].min_cumulative_topup_usd`	string	항상	같은 금액의 USD 문자열(소수 6자리), 형식 `^-?[0-9]+\.[0-9]{6}$`
`data[].max_concurrent_jobs`	integer	항상	동시 실행 잡 수, 최소 1
`data[].max_queued_jobs`	integer		조직 대기열 상한
`data[].monthly_limit_micro_usd`	integer	항상	월 사용 한도, null이면 상한 없음(Custom), null 가능
`data[].monthly_limit_usd`	string	항상	월 한도(USD 정수), null 가능
`policy`	object	항상	정책 요약, 기준은 누적 결제 충전액, 강등 없음, 월은 UTC 달력 월
`policy.basis`	`cumulative_paid_topups`		기준
`policy.demotion`	`false`		강등 여부
`policy.month_basis`	`UTC calendar month`		월 기준
`policy.status`	string		승인 전이면 draft

{
  "data": [
    {
      "tier": 1,
      "name": "Tier 1",
      "min_cumulative_topup_micro_usd": 5000000,
      "min_cumulative_topup_usd": "5.000000",
      "max_concurrent_jobs": 2,
      "max_queued_jobs": 10,
      "monthly_limit_micro_usd": 100000000,
      "monthly_limit_usd": "100.000000"
    }
  ],
  "policy": {
    "basis": "cumulative_paid_topups",
    "demotion": false,
    "month_basis": "UTC calendar month",
    "status": "draft"
  }
}

오류

HTTP	코드	다시 시도	뜻
400	`invalid_request`	아니오	본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다
401	`api_key_required`	아니오	API 키 엔드포인트에 Authorization: Bearer 헤더가 없습니다
401	`api_key_revoked_leaked`	아니오	공개 유출 신고로 자동 폐기된 키입니다, 새 키를 발급하세요
401	`invalid_api_key`	아니오	모르는 키이거나 폐기, 만료, 체크섬 불일치입니다(종료된 xeno_ 접두사 포함)
401	`session_required`	아니오	콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다
403	`insufficient_permission`	아니오	역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다
429	`rate_limited`	가능	이 키 또는 조직의 요청이 너무 많습니다, retryafters만큼 기다리세요
500	`internal_error`	가능	예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요

오류 봉투 모양과 전체 코드 표는 오류 코드에 있습니다

예시

curl "https://xenoci.com/api/runner/v1/tiers" \
  -H "Authorization: Bearer $XENOCI_API_KEY"

다음 단계

조직 티어 조회 GET /v1/organizations/{org_id}/tier