*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

InventoryItem

คลังไอเท็ม

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของรายการสินค้าคงคลัง

รูปแบบ: users/{user_id}/inventory-items/{inventory_item_id}.

หนึ่งในรายการต่อไปนี้สำหรับdetails:

assetDetailsobject

เต็มถ้ารายการนี้เป็นสินทรัพย์.

badgeDetailsobject

เหรียญตรา.

gamePassDetailsobject

เต็มถ้ารายการนี้เป็นบัตรผ่านเกม.

privateServerDetailsobject

เต็มถ้ารายการนี้เป็นเซิร์ฟเวอร์ส่วนตัว.

addTimestring
เอาต์พุตเท่านั้น

คลังไอเท็มเช่น เหรียญตรา

ฟิลด์นี้ขณะนี้ยังไม่ได้รับการเติมเต็มสำหรับบัตรผ่าน. สตริงนี้มีรูปแบบประทับเวลา

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
เวอร์ชัน Beta

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

คลังไอเท็ม

รายการสินค้าคงคลังที่คืนมาขึ้นอยู่กับตัวเลือกของผู้ใช้เป้าหมายภายใต้ การตั้งค่า > ความเป็นส่วนตัว > คลังไอเท็ม? :

  • หากผู้ใช้ให้การเห็นสินค้าคงคลังแก่ "ทุกคน" กุญแจ API หรือโทเค็น OAuth2 ใดๆ คลังไอเท็มไม่ว่าจะมีขอบเขตอะไรหรือใครสร้างมัน
  • หากผู้ใช้ไม่ได้ให้การมองเห็นสินค้าคงคลังแก่ "ทุกคน":
    • สินค้าคงคลังของพวกเขายังสามารถดูได้ด้วยกุญแจ API ที่สร้างโดยผู้ใช้เป้าหมายด้วยสิทธิ์ สินค้าคงคลัง: อ่าน * สินค้าคงคลังของพวกเขายังสามารถดูได้ด้วยโทเค็น OAuth2 หากผู้ใช้เป้าหมายอนุญาตให้แอปขอสิทธิ์สำหรับขอบเขต user.inventory-item:read

ขีดจํากัดอัตรา:

  • คีย์ API - 100 คำขอ/นาทีต่อเจ้าของคีย์ API (สามารถเป็นผู้ใช้หรือกลุ่ม) ข้อจํากัดอัตราจะถูกบังคับใช้กับคีย์ API ทั้งหมดของเจ้าของ API
  • โทเค็น OAuth2 - 20 คำขอ/นาทีต่อโทเค็นการเข้าถึง OAuth2
คำขอพารามิเตอร์เส้นทาง
user_idstring
จำเป็นต้องมี

ID ผู้ใช้.

พารามิเตอร์คิวรี
maxPageSizenumber

จํานวนสินค้าคงคลังสูงสุดที่จะส่งคืนบริการอาจ返回值น้อยกว่านี้หากไม่ระบุ จะมีการคืนสินค้าคงคลังไม่เกิน 10 รายการมูลค่าสูงสุดคือ 100 และมูลค่าที่สูงกว่าจะถูกตั้งเป็น 100.

pageTokenstring

โทเค็นหน้าที่ได้รับจากการโทรก่อนหน้านี้เพื่อดึงหน้าต่อไป

เมื่อจัดหน้า พารามิเตอร์อื่น ๆ ทั้งหมดที่ให้กับการโทรต่อไปจะต้องตรงกับการโทรที่ให้โทเค็นหน้า.

การตอบกลับ

รายการสินค้าคงคลังในคอลเลกชันรากฐาน

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"

}