Microsoft Store 서비스 간 REST 참조(collections, purchase, clawback, grant, recurrences)를 찾고 계신가요? API 탭 아래의 Microsoft Store REST APIs에 있습니다.
이 섹션의 내용
시작하기
개요, 제품 유형, Partner Center 설정, 테스트, 라이선싱, 문제 해결.
기본 사항
기본 스토어 작업, DLC, 트라이얼, 소모품, 번들, DWOB, 업데이트.
서비스에서 관리
서비스 인증, 사용 권한 쿼리, 구독, 환불, User Store ID.
PC 관련 고려 사항
DRM, 라이선스 토큰, 스토어 계정 불일치 처리, 샌드박스 전환.
Microsoft Store REST API
v8/v9 collections, purchase, clawback, grant, recurrences 엔드포인트에 대한 참조입니다. 전체 참조는 이제 API 탭 아래의 Microsoft Store REST APIs에 있습니다.
프랜차이즈 게임 허브
여러 제품을 단일 스토어 프랜차이즈 허브 아래에 그룹화합니다.
큰 그림: 각 요소가 어떻게 연결되는가
- Partner Center — 제품(기본 게임, 추가 기능, 번들, 시즌 패스, 구독, 소모품)을 만들고, 가격과 사용 가능 여부를 정의하고, 식별자(StoreId, Product ID, BigId, SKU ID)를 할당하는 곳입니다.
MicrosoftGame.config— 타이틀 패키지 내부에 포함되며TitleId,StoreId,MSAAppId를 통해 실행 중인 실행 파일을 스토어 제품에 바인딩합니다.- XStore 런타임 API (
XStore*) — 제품을 열거하고, 라이선스 및 사용 권한을 쿼리하고, 구매 UI를 표시하고, 소모품 이행을 보고하기 위해 게임에서 이루어지는 클라이언트 측 호출입니다. - XPackage API (
XPackage*) — 선택적 패키지(DLC)를 마운트하고 라이선스를 부여하고, 청크를 설치하고, 패키지 상태 변경을 관찰합니다. - Microsoft Store S2S REST API — 백엔드가 호출하여 권한 있는 방식으로 사용 권한을 쿼리하고, 소모품을 이행하고, 제품을 부여하고, 구독을 조회하고, 환불/clawback을 처리하는 서버 측 엔드포인트입니다.
- User Store ID (UserStoreId) — 타이틀이
XUserGetTokenAndSignatureAsync(또는XStoreGetUserCollectionsIdAsync/XStoreGetUserPurchaseIdAsync)를 통해 얻는 짧은 수명의 키로, 서비스가 해당 사용자를 대신하여 스토어를 호출할 수 있도록 서비스에 전달됩니다.
클라이언트와 서비스
거의 모든 스토어 시나리오에는 클라이언트 측(XStore)과 서비스 측(S2S REST) 경로가 모두 있습니다. 실시간 UX(구매 버튼 표시, 콘텐츠 잠금 해제, 소모품 지출 보고)에는 클라이언트를 사용하고, 권한이 중요한 경우(타이틀 재설치를 견뎌야 하는 가상 통화 지출 이행, 프로모션 항목 부여, Game Pass 감지, 환불 처리)에는 서비스를 사용하세요. 신뢰할 수 있는 패턴은 다음과 같습니다.- 클라이언트가 구매 또는 지출을 감지하고 즉각적인 UX를 표시합니다.
- 클라이언트가 UserStoreId를 서비스에 전송합니다.
- 서비스가 Store S2S API를 호출하여 사용 권한을 확인하거나 소모품을 이행하고, 기록의 원본 데이터베이스를 업데이트합니다.