*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

InventoryItem

代表使用者庫道具欄中的物品。

特性

pathstring

庫存道具目的資源路徑。

格式：users/{user_id}/inventory-items/{inventory_item_id}.

details 請選擇其中一項：

assetDetailsobject

如果此項目是素材，會被填滿。.

badgeDetailsobject

如果此項目是徽章，會被填滿。.

gamePassDetailsobject

如果此項目是遊戲通行特權證，會被填滿。.

privateServerDetailsobject

如果此項目是私人伺服器，就會填滿。.

addTimestring
僅限輸出

物品被新增到使用者的道具欄時間。例如，使用者購買了私人伺服器或獲得了徽章時間。

此欄目目前對通行證尚未填充。. 此字串的格式為 Timestamp。

基本網址
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
Beta

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 的值設為 100。.

pageTokenstring

從以前的呼叫中收到的頁面代幣，用於取回後續頁面。

當頁面分頁時，所有其他參數提供給後續呼叫的頁面代幣必須與提供頁面代幣的呼叫匹配。.

filterstring

此欄位可設為過濾返回的資源。

查看 過濾 文件以獲得更多信息。.

回應

父集合中的庫收藏項目列表。

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"

}