The resource path of the inventory item.
Format: users/{user_id}/inventory-items/{inventory_item_id}.
InventoryItem
Represents an item in a user's inventory.
Thuộc Tính
Một trong những thông tin sau đây cho details:
Populated if this item is an asset.
Populated if this item is a badge.
Populated if this item is a game pass.
Populated if this item is a private server.
The time when the item was added to the user's inventory. For example, the time when the user purchased a private server or was awarded a badge.
This field is currently not populated for passes. Chuỗi này được định dạng là Dấu thời gian.
URL Cơ Sở
https://apis.roblox.comTài nguyên 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
List the inventory items in a user's inventory.
The inventory items returned depend on the target user’s choice under Settings > Privacy > Who can see my inventory?:
- If the user granted inventory visibility to "Everyone," then any API key or OAuth2 token can be used to view the target’s inventory, no matter what scopes it has or who created it.
- If the user has not granted inventory visibility to "Everyone":
- Their inventory can still be viewed with an API key created by the target user with Inventory: Read permission.
- Their inventory can still be viewed with an OAuth2 token if the target user authorizes an app requesting permissions for the user.inventory-item:read scope.
Rate Limits:
- API Keys - 100 requests/minute per API key owner (can be user or group). Rate limits are enforced across all of an owner's API keys.
- OAuth2 Tokens - 20 requests/minute per OAuth2 access token
The user ID.
The maximum number of inventory items to return. The service might return fewer than this value. If unspecified, at most 10 inventory items are returned. The maximum value is 100 and higher values are set to 100.
A page token, received from a previous call, to retrieve a subsequent page.
When paginating, all other parameters provided to the subsequent call must match the call that provided the page token.
This field may be set in order to filter the resources returned.
See the filtering documentation for more information.
Phản HồiinventoryItemsarray<InventoryItem> nextPageTokenstring
A list of InventoryItems in the parent collection.
The InventoryItems from the specified User.
A token that you can send as a pageToken parameter to retrieve the next page. If this field is omitted, there are no subsequent pages.
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}'Phản Hồi
{
"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"
}