> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User Store ID 키 갱신

> 백엔드가 계속 호출을 인증할 수 있도록 30일 수명이 만료되기 전에 Microsoft Store 서비스에서 User Store ID 키를 갱신합니다.

이 문서에서는 User Store ID 키를 갱신하는 방법을 설명합니다.

[User Store ID 키를 생성](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-requesting-userstoreid.md#step-4-create-a-user-store-id-key)하면 30일의 수명을 가집니다. 그 기간 동안 키는 Microsoft Store 서비스에 대한 호출을 인증할 수 있습니다. 만료 전에 갱신하여 동일한 Microsoft Entra 앱 클라이언트 ID와 사용자 identity에 대한 새 키를 생성할 수 있습니다.

## 사전 요구 사항

User Store ID 키를 갱신하려면 다음 키/토큰이 필요합니다.

* 대상(audience) URI 값이 `https://onestore.microsoft.com`인 Microsoft Entra ID 액세스 토큰
* [앱의 클라이언트 측 코드에서 생성된](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-requesting-userstoreid.md#step-4-create-a-user-store-id-key) 만료된 Microsoft Store ID 키

자세한 내용은 [서비스 간 인증을 위한 User Store ID 요청](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-requesting-userstoreid.md)을 참고하세요.

## 요청

### 요청 구문

| 키 유형 | 메서드 | 요청 URI |
| - | - | - |
| `Collections` | `POST` | `https://collections.mp.microsoft.com/v6.0/b2b/keys/renew` |
| `Purchase` | `POST` | `https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew` |

### 요청 헤더

| 헤더 | 유형 | 설명 |
| - | - | - |
| `Host` | `string` | `collections.mp.microsoft.com` 또는 `purchase.mp.microsoft.com` 값으로 설정해야 합니다. |
| `Content-Length` | `number` | 요청 본문의 길이입니다. |
| `Content-Type` | `string` | 요청 및 응답 유형을 지정합니다. 현재 지원되는 유일한 값은 `application/json`입니다. |

### 요청 본문

| 매개변수 | 유형 | 설명 | 필수 |
| - | - | - | - |
| `serviceTicket` | `string` | Microsoft Entra ID 서비스 액세스 토큰입니다. | 예 |
| `key` | `string` | 만료된 Microsoft Store ID 키입니다. | 예 |

### 요청 예

```syntax theme={null}
POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew HTTP/1.1
Content-Length: 2774
Content-Type: application/json
Host: collections.mp.microsoft.com

{
    "serviceTicket": "eyJ0eXAiOiJKV1QiLCJhb...",
    "Key": "eyJ0eXAiOiJKV1QiLCJhbG..."
}
```

## 응답

### 응답 본문

| 매개변수 | 유형 | 설명 |
| - | - | - |
| `key` | `string` | Microsoft Store collections API 또는 purchase API에 대한 향후 호출에 사용할 수 있는 갱신된 User Store ID 키입니다. |

### 응답 예

```syntax theme={null}
HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: bfebe80c-ff89-4c4b-8897-67b45b916e47
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2019 07:31:12 GMT

{
    "key":"eyJ0eXAi..."
}
```

## 오류 코드

| 코드 | 오류 | 내부 오류 코드 | 설명 |
| - | - | - | - |
| 401 | Unauthorized | `AuthenticationTokenInvalid` | Microsoft Entra ID 액세스 토큰이 유효하지 않습니다. 경우에 따라 `ServiceError`에 토큰 만료 또는 누락된 `appid` 클레임과 같은 자세한 정보가 포함됩니다. |
| 401 | Unauthorized | `InconsistentClientId` | User Store ID 키의 `clientId` 클레임과 Microsoft Entra ID 액세스 토큰의 `appid` 클레임이 일치하지 않습니다. |

## 참조 API 문서

* [XStore (API 내용)](https://docs.xbox.com/ko/reference/system/xstore/xstore_members.md)

## 참고

[커머스(개요)](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-commerce-overview.md)

[서비스에서 제품 관리](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-authenticating-service.md)

[서비스 간 인증을 위한 User Store ID 요청](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-requesting-userstoreid.md)

[X-token 또는 OAuth 2.0으로 서비스에서 User Store ID 요청](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)

[Microsoft Store API로 서비스 인증](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-authenticating-service.md)

[Microsoft.StoreServices library (GitHub)](https://github.com/microsoft/Microsoft-Store-Services)

[Microsoft.StoreServices sample (GitHub)](https://github.com/microsoft/Microsoft-Store-Services-Sample)

[XStore (API 참조)](https://docs.xbox.com/ko/reference/system/xstore/xstore_members.md)


## Related topics

- [서비스 간 인증을 위한 User Store ID 요청](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-requesting-userstoreid.md)
- [Microsoft Store API로 서비스 인증하기](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-authenticating-service.md)
- [X-token 또는 OAuth 2.0을 사용하여 서비스에서 User Store ID 요청](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [XStoreGetUserCollectionsIdResult](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoregetusercollectionsidresult.md)
- [XStoreGetUserCollectionsIdAsync](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoregetusercollectionsidasync.md)