Membership

내 멤버십/정책 스냅샷 조회

현재 인증 주체의 멤버십/정책 스냅샷 조회.

응답은 AuthPolicyService 평가 결과(PrincipalContext + quota/rate snapshot)를 그대로 노출한다.

get/v1/membership/me

Request

  • Base URL: https://api.xdata.kr (the document declares no server; this is the origin it was published from)
  • URL: https://api.xdata.kr/v1/membership/me
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL https://api.xdata.kr/oauth/authorize, token URL https://api.xdata.kr/oauth/token)

Query parameters

env_scope'production' | 'real_test' | 'sandbox' nullable

환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

Headers

Authorizationstring nullable
X-Env-Scope'production' | 'real_test' | 'sandbox' nullable

환경을 고릅니다. 값은 production · real_test · sandbox 중 하나입니다. 경로 접두(/v1/sandbox/... · /v1/test/... · /v1/production/...) · X-Env-Scope 헤더 · env_scope 쿼리 가운데 한 통로로 반드시 보내야 합니다. 빼면 자동으로 채우지 않고 거절하며, 두 통로에 서로 다른 값을 담아도 거절합니다. 거절은 HTTP 422 이고 오류 코드는 VALIDATION_ENV_SCOPE_MISMATCH 입니다.

Response

현재 주체의 멤버십·정책 스냅샷.

successboolean required

조회 성공 여부. 이 라우트는 성공 시 늘 true 다.

policy_decision_idstring required

이 조회를 평가한 정책 결정의 식별자. 문의 시 이 값을 전달한다.

principal_kind'client' | 'console_user' | 'admin_user' | 'legacy_api_key' | 'system' nullable

인증 주체의 종류.

organization_idinteger nullable

소속 조직 식별자. 조직 밖 주체는 없다.

organization_role'OWNER' | 'ADMIN' | 'MEMBER' nullable

그 조직에서의 역할.

membership_tier'FREE' | 'PAID' nullable

멤버십 등급.

plan_namestring nullable

멤버십이 가리키는 요금제의 공개명(예: 라이트, 스탠다드, PRO). 멤버십이 없으면 없다. 주의: 가입 직후 데모 단계 계정도 공개명은 「라이트」 로 나온다 - 단계(데모 vs 정식)를 가르려면 이 이름이 아니라 membership_tier(FREE 또는 PAID)와 환경을 본다.

subscription_status'ACTIVE' | 'PAUSED' | 'CANCELED' | 'EXPIRED' nullable

구독 상태.

demo_ends_atstring nullable

데모 환경이 닫히는 시각(ISO 8601, KST). 기한이 없거나 데모 승인 전이면 없다.

Changes

No recorded changes to this operation across all 1 revision of this API.