库存物品目的资源路径。
格式：users/{user_id}/inventory-items/{inventory_item_id}.
*此内容使用人工智能（Beta）翻译，可能包含错误。若要查看英文页面，请点按 此处。
InventoryItem
代表用户库存中的物品。
属性
请为details选择其中一项：
如果该项目是素材，则填充。.
如果该项目是徽章，则填充。.
如果该项目是游戏通行证，则已填充。.
如果该项目是私有服务器，则会被填充。.
物品被添加到用户的道具时间。例如，用户购买了私人服务器或获得了徽章的时间。
该字段目前对通行证尚未填充。. 此字符串格式为 FieldMask。
基本网址
https://apis.roblox.comInventoryItem 资源
{
"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 个请求/分钟
用户ID。.
返回传的库存物品最大数量。服务可能返回小于此值。如果未指定，最多返回 10 个库存物品。最大值为 100，更高值设置为 100。.
从前一次调用收到的页面代币，用于检索后续页面。
当页面分页时，所有其他参数提供给后续调用的必须与提供页面代币的调用匹配。.
该字段可以设置以便筛选返回的资源。
请参阅过滤文档获取更多信息。.
答复inventoryItemsarray<InventoryItem> 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"
}