*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

InventoryItem

사용자의 인벤토리에 있는 아이템을 나타냅니다.

특성

pathstring

인벤토리 항목의 리소스 경로.

형식: users/{user_id}/inventory-items/{inventory_item_id}.

details에 대해 다음 중 하나 선택 가능:

assetDetailsobject

이 항목이 자산인 경우 채워집니다.

badgeDetailsobject

이 항목이 배지인 경우 채워집니다.

gamePassDetailsobject

이 항목이 게임 패스인 경우 채워집니다.

privateServerDetailsobject

이 항목이 개인 서버인 경우 채워집니다.

addTimestring

출력 전용

아이템이 사용자의 인벤토리에 추가된 시간. 예를 들어, 사용자가 개인 서버를 구매하거나 배지를 받은 시간입니다.

이 필드는 현재 패스에 채워지지 않았습니다. 이 문자열은 Timestamp 형식으로 지정됩니다.

기본 URL

https://apis.roblox.com

InventoryItem 리소스

{
  "path": "users/123/inventory-items/some-inventory-item-id",
  "assetDetails": {
    "assetId": "12928981934",
    "inventoryItemAssetType": "INVENTORY_ITEM_ASSET_TYPE_UNSPECIFIED",
    "instanceId": "173413781720",
    "collectibleDetails": {
      "itemId": "521cca19-75bb-4e05-a0af-633b1532c24d",
      "instanceId": "a8a27d38-ee51-4cf4-8b0a-485d0dfd8607",
      "instanceState": "COLLECTIBLE_ITEM_INSTANCE_STATE_UNSPECIFIED",
      "serialNumber": 160
    }
  },
  "addTime": "2023-07-05T12:34:56Z"
}

InventoryItem

List Inventory Items
베타

GET /cloud/v2/users/{user_id}/inventory-items

사용자의 인벤토리에 인벤토리 항목을 나열합니다.

반환된 인벤토리 항목은 대상 사용자의 설정 > 개인 정보 > 내 인벤토리를 볼 수 있는 사람 아래의 선택에 따릅니다.

사용자가 "모두"에 인벤토리 가시성을 부여하면, 범위나 누가 만들었는지와 상관없이 API 키나 OAuth2 토큰을 사용하여 대상의 인벤토리를 볼 수 있습니다.
사용자가 "모두"에 인벤토리 가시성을 부여하지 않은 경우:
- 대상 사용자가 인벤토리: 읽기 권한으로 생성한 API 키로 여전히 인벤토리를 볼 수 있습니다.
- 대상 사용자가 권한을 요청하는 user.inventory-item:read 범위에 대한 앱 요청을 승인하면 OAuth2 토큰으로 인벤토리를 여전히 볼 수 있습니다.

속도 제한:

API 키 - API 키 소유자당 분당 100 요청(사용자 또는 그룹일 수 있음). 속도 제한은 소유자의 모든 API 키에 적용됩니다.
OAuth2 토큰 - OAuth2 액세스 토큰당 20개의 요청/분

요청경로 매개 변수

user_idstring

필수

사용자 ID.

쿼리 매개 변수

maxPageSizenumber

반환할 인벤토리 아이템의 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 10개의 인벤토리 항목이 반환됩니다.최대 값은 100이며 더 높은 값은 100으로 설정됩니다.

pageTokenstring

이전 호출에서 받은 페이지 토큰으로, 이후 페이지를 검색합니다.

페이징할 때 후속 호출에 제공된 모든 다른 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filterstring

이 필드는 반환된 리소스를 필터링하기 위해 설정될 수 있습니다.

자세한 내용은 필터링 문서를 참조하십시오.

응답

부모 컬렉션의 인벤토리 아이템 목록.

inventoryItemsarray<InventoryItem>

지정된 사용자의 InventoryItems.

nextPageTokenstring

다음 페이지를 검색하기 위해 pageToken 매개변수로 보낼 수 있는 토큰입니다. 이 필드가 생략되면 후속 페이지가 없습니다.

GET /cloud/v2/users/{user_id}/inventory-items

curl -L -X GET 'https://apis.roblox.com/cloud/v2/users/{user_id}/inventory-items?maxPageSize=10&pageToken={string}&filter={string}' \
  -H 'x-api-key: {your-api-key}'

응답

{
  "inventoryItems": [
    {
      "path": "users/123/inventory-items/some-inventory-item-id",
      "assetDetails": {
        "assetId": "12928981934",
        "inventoryItemAssetType": "INVENTORY_ITEM_ASSET_TYPE_UNSPECIFIED",
        "instanceId": "173413781720",
        "collectibleDetails": {
          "itemId": "521cca19-75bb-4e05-a0af-633b1532c24d",
          "instanceId": "a8a27d38-ee51-4cf4-8b0a-485d0dfd8607",
          "instanceState": "COLLECTIBLE_ITEM_INSTANCE_STATE_UNSPECIFIED",
          "serialNumber": 160
        }
      },
      "addTime": "2023-07-05T12:34:56Z"
    }
  ],
  "nextPageToken": "string"
}

InventoryItem

특성

InventoryItem

List Inventory Items베타

List Inventory Items
베타