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

# GET (/users/me/inventory)

> GET (/users/me/inventory)

# GET (/users/me/inventory)

제공된 사용자와 현재 연결된 인벤토리 집합을 호출자에게 다시 제공합니다.
이 URI의 도메인은 `inventory.xboxlive.com`입니다.

* [설명](#ID4EV)
* [쿼리 문자열 매개변수](#ID4EHB)
* [샘플 요청](#ID4EDE)
* [응답 본문](#ID4ERE)

## 설명

이 호출의 일부로 정책 검사, 시행 또는 필터링이 수행되지 않습니다. 호출자는 반환되는 결과의 범위를 좁히기 위해 쿼리 매개변수를 전달할 수 있습니다.

호출자는 이전 응답을 통해 제공된 연속 토큰을 사용하여 결과를 페이지 매기며 탐색할 수 있습니다: **/users/me/inventory?continuationToken=continuationTokenString**.

호출자는 특정 항목에 대한 정보를 보려면 특정 항목 URL과 함께 details API에 호출할 수 있습니다.

## 쿼리 문자열 매개변수

| 매개변수 | 형식 | 설명 |
| - | - | - |
| availability | string | 반환할 항목의 현재 사용 가능 여부입니다. 기본값은 "Available"이며, 현재 날짜가 시작 날짜와 종료 날짜 범위 사이에 있는 항목을 반환합니다. 기타 값으로는 모든 항목을 반환하는 "All"과, 현재 날짜가 시작 날짜와 종료 날짜 범위 외에 있어 현재 사용할 수 없는 항목을 반환하는 "Unavailable"이 있습니다. |
| container | string | 선택 사항. 값을 게임의 Product ID로 설정하면 인벤토리의 결과에 해당 게임과 관련된 항목만 포함됩니다. 특히 서버에서 인벤토리를 호출하여 특정 게임의 제품으로 결과를 필터링할 때 유용합니다. |
| expandSatisfyingEntitlements | string | 응답이 반환된 결과 내에서 사용자가 가진 모든 만족 엔티틀먼트(satisfying entitlement)를 포함할지 여부를 나타내는 플래그입니다. 기본값은 "false"입니다. 이 매개변수가 "true" 값으로 사용되면 번들 항목, XBOX One으로 마이그레이션된 XBOX 360 구매, 구독 혜택 등과 같은 만족 엔티틀먼트를 통해 사용자에게 부여된 모든 제품이 결과에 추가됩니다. 이 값이 "false"인 경우 결과에는 번들의 ProductID와 같은 상위 항목만 반환되며 개별 포함 항목은 반환되지 않습니다. **참고:** 이 매개변수를 "true" 값으로 사용하는 것은 itemType 매개변수가 URI에 포함되지 않은 경우에만 지원됩니다. 그렇지 않으면 HTTP 400 오류가 발생합니다. |
| productIds | string | 사용자의 인벤토리에서 구체적으로 검색하려는 ProductId의 컬렉션으로, ','로 구분됩니다. 사용자가 제공된 ProductID를 인벤토리 결과에 갖고 있지 않은 경우 해당 항목은 API 호출의 결과에 나타나지 않습니다. 번들의 productID를 expandSatisfyingEntitlements 매개변수를 true로 설정하여 전달하면 번들에 포함된 모든 항목이 호출 결과에 반환됩니다(쿼리 문자열에서 해당 productIds를 지정했는지 여부와 관계없이). |
| state | string | 반환할 항목의 상태입니다. 기본값은 모든 항목을 반환하는 "all"입니다. 기타 값으로는 사용 가능한 항목만 반환해야 함을 나타내는 "Enabled", 일시 중단된 항목만 반환해야 함을 나타내는 "Suspended", 만료된 항목만 반환해야 함을 나타내는 "Expired", 취소된 항목만 반환해야 함을 나타내는 "Cancelled", 갱신된 항목만 반환해야 함을 나타내는 "Renewed"가 있습니다. |

이러한 매개변수 외에도 리소스는 표준 페이징 메커니즘을 지원합니다.

## 샘플 요청

이 URI 메서드의 정규화된 도메인 이름은 `https://inventory.xboxlive.com/users/me/inventory입니다.
		 `

> **참고:**\
> 어떤 사용자를 고려할지는 제공된 토큰에 따라 다르며, 여러 사용자를 포함할 수 있습니다. 단일 사용자의 인벤토리를 원할 경우 배타적으로 고려하려는 특정 사용자에 대한 사용자 해시도 제공해야 합니다.

.

## 응답 본문

호출이 성공하면 서비스는 인벤토리 항목의 배열을 반환합니다. [inventoryItem (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-inventoryitem)을 참조하세요.

### 샘플 응답

```cpp theme={null}
{
  "pagingInfo": {
    "continuationToken": string,
    "totalItems": int
  },
  "items":
  {
    "url": string,
    "itemType": "Music",
    "titleId": string,
    "containers": string,
    "obtained": DateTime,
    "startDate": DateTime,
    "endDate": DateTime,
    "state": "Enabled"  
}

```

## 참고 항목

##### 상위 항목

[/users/me/inventory](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/uri-inventory)

##### 추가 정보

[EDS Common Headers](https://devdocs.xbox.com/ko/reference/live/rest/additional/edscommonheaders)

[EDS Parameters](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsparameters)

[EDS Query Refiners](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URIs](https://devdocs.xbox.com/ko/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[추가 참조](https://devdocs.xbox.com/ko/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Get User Inventory](https://devdocs.xbox.com/services/playfab/api-references/rest/admin/player-item-management/get-user-inventory.md)
- [Get Character Inventory](https://devdocs.xbox.com/services/playfab/api-references/rest/server/player-item-management/get-character-inventory.md)
- [Requesting a User Store ID from your service with X-tokens or OAuth 2.0](https://devdocs.xbox.com/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [Solicitud de un User Store ID desde su servicio con tokens X u OAuth 2.0](https://devdocs.xbox.com/es/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)
- [使用 X-token 或 OAuth 2.0 从服务中请求 User Store ID](https://devdocs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-requesting-userstoreid-oauth.md)