Con đường tài nguyên của mục tồn kho.
Định dạng: users/{user_id}/inventory-items/{inventory_item_id}.
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
InventoryItem
Đại diện cho một mặt hàng trong kho của người dùng.
Thuộc Tính
Một trong những thông tin sau đây cho details:
Được lấp đầy nếu mục này là một tài sản.
Được lấp đầy nếu mục này là một huy hiệu.
Được lấp đầy nếu mục này là một thẻ trò vé.
Được lấp đầy nếu mục này là một máy chủ riêng.
Thời gian mà mục được thêm vào kho hàng của người dùng. Ví dụ, thời gian mà người dùng mua một máy chủ riêng tư hoặc được trao một huy hiệu.
Trường này hiện không được lấp đầy cho các thẻ. 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
Danh sách các mục tồn kho trong kho của người dùng.
Các mục tồn kho trả về phụ thuộc vào lựa chọn của người dùng mục tiêu dưới Cài đặt > Riêng tư > Ai có thể xem kho hàng của tôi? :
- Nếu người dùng cho phép hiển thị kho hàng cho "Tất cả mọi người," thì bất kỳ chìa khóa API hoặc token OAuth2 nào cũng có thể được sử dụng để xem kho hàng của mục tiêu, bất kể phạm vi nào nó có hoặc ai tạo nó.
- Nếu người dùng chưa cho phép hiển thị kho hàng cho "Tất cả":
- Hàng tồn kho của họ vẫn có thể được xem với một chìa khóa API được tạo bởi người dùng mục tiêu với quyền Hàng tồn kho: Đọc .
- Hàng tồn kho của họ vẫn có thể được xem với một token OAuth2 nếu người dùng mục tiêu cho phép một ứng dụng yêu cầu quyền truy cập cho phạm vi user.inventory-item:read .
Giới hạn tỷ lệ:
- Chìa khóa API - 100 yêu cầu/phút cho mỗi chủ sở hữu chìa khóa API (có thể là người dùng hoặc nhóm). Giới hạn tỷ lệ được áp dụng cho tất cả các chìa khóa API của chủ sở hữu.
- Token OAuth2 - 20 yêu cầu/phút cho mỗi token truy cập OAuth2
ID người dùng.
Số lượng tối đa các mục tồn kho để trả lại.Dịch vụ có thể trả về ít hơn giá trị này.Nếu không được xác định, tối đa 10 mục tồn kho được trả lại.Giá trị tối đa là 100 và giá trị cao hơn được đặt thành 100.
Một token trang, nhận từ cuộc gọi trước, để lấy lại trang tiếp theo.
Khi paginate, tất cả các tham số khác được cung cấp cho cuộc gọi tiếp theo phải phù hợp với cuộc gọi cung cấp token trang.
Trường này có thể được đặt để lọc các tài nguyên được trả về.
Xem tài liệu lọc filtering để có thêm thông tin.
Phản HồiinventoryItemsarray<InventoryItem> nextPageTokenstring
Một danh sách InventoryItems trong bộ sưu tập cha.
Các Vật phẩm Tồn kho từ Người dùng được chỉ định.
Một token mà bạn có thể gửi như một tham số pageToken để lấy trang tiếp theo. Nếu trường này bị bỏ qua, không có trang tiếp theo.
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"
}