คลังสินค้าของผู้ใช้

API สินค้าคงคลัง ช่วยให้คุณสามารถเข้าถึงข้อมูลส่วนใหญ่เดียวกับหน้า Roblox สินค้าคงคลังของฉัน ได้คุณสามารถตรวจสอบว่าผู้ใช้เป็นเจ้าของไอเทมแต่ละรายการและดูรายชื่อไอเทมทั้งหมดที่ผู้เล่นเป็นเจ้าของได้

คําตอบจาก API คลังสินค้า รวมถึงรายการจากหมวดหมู่ต่อไปนี้:

• เสื้อผ้า (อุปกรณ์เสริม, ท่อนล่าง, เสื้อผ้าคลาสสิก, รองเท้า, ท็อปส์)
• การซื้อและรางวัล (ตรา ผ่าน สถานที่ที่ซื้อ เซิร์ฟเวอร์ส่วนตัว)
• ไอเทมอวาตาร์ (แอนิเมชั่นอวาตาร์ หัวหน้าแบบคลาสสิก อีโมท ใบหน้า ผม หัวหน้า)

ก่อนที่จะใช้ API สินค้าคงคลัง คุณต้อง สร้างคีย์ API หรือ กำหนดค่า OAuth 2 สำหรับแอปของคุณตัวอย่างบนหน้านี้ใช้คีย์ API

ตรวจสอบเจ้าของรายการ

หากคุณต้องการตรวจสอบว่าผู้ใช้เป็นเจ้าของรายการเฉพาะ (เช่น จํากัด ตรา เหรียญตราหรือเซิร์ฟเวอร์ส่วนตัว) ให้ใช้พารามิเตอร์ filter เพื่อตรวจสอบรายการแยกกับจุลภาคของหนึ่งหรือมากกว่าหนึ่งรหัสตัวอย่างโค้ดนี้ตรวจสอบสำหรับสามรหัสสินทรัพย์:

const https = require('node:https');

const userId = 11111111111;
const hostname = 'apis.roblox.com';
const path = `/cloud/v2/users/${userId}/inventory-items`;
const params = '?filter=assetIds=62724852,1028595,4773588762';

const url = 'https://' + hostname + path + params;

const apiKey = '123456789012345678901234567890123456789012345678';

const options = {
  headers: {
    'x-api-key': `${apiKey}`,
  },
};

https
  .get(url, options, (response) => {
    console.log('statusCode:', response.statusCode);
    let data = '';
    response.on('data', (d) => {
      data += d;
    });
    response.on('end', () => {
      if (response.statusCode === 200) {
        const jsonData = JSON.parse(data);
        console.log('Response Data:', JSON.stringify(jsonData, null, 2));
      } else {
        console.error('Error:', response.statusCode, response.statusMessage);
      }
    });
  })
  .on('error', (e) => {
    console.error(e);
  });

คำตอบต่อไปนี้บ่งชี้ว่าผู้ใช้เป็นเจ้าของหนึ่งในสามรายการ:

{
  "inventoryItems": [
    {
      "path": "users/11111111111/inventory-items/VVNFUl9BU1NFVF9JRD0yMDAxMDUxMTkzODg",
      "assetDetails": {
        "assetId": "1028595",
        "inventoryItemAssetType": "CLASSIC_TSHIRT",
        "instanceId": "200105119388"
      }
    }
  ],
  "nextPageToken": ""
}

กรองรายการ

หากต้องการแสดงตัวอย่างเช่น เฉพาะของสะสมที่ผู้ใช้เป็นเจ้าของเท่านั้น ให้ใช้รหัสเดียวกับด้านบน แต่เปลี่ยนพารามิเตอร์ filter เป็นอื่น

const params = '?filter=onlyCollectibles=true;inventoryItemAssetTypes=*';

ผสมและจับคู่ตัวกรองโดยใช้รายการแยกกับจุลภาค นี่คือตัวอย่างสองสามตัว:

filter=onlyCollectibles=true;inventoryItemAssetTypes=HAT,CLASSIC_PANTS

filter=badgeIds=111111,222222;gamePassIds=777777;privateServerIds=999999

filter=gamePasses=true;badges=true

การโทรส่วนใหญ่ไปยัง API ไม่ต้องการสิทธิ์เฉพาะใดๆ แต่ตัวกรองหลายตัวต้องการสิทธิ์อ่านคลังสินค้าสำหรับข้อมูลเพิ่มเติม ดู การกรอง

แสดงผลลัพธ์เป็นหน้า

หากคำตอบรวมถึงค่าสําหรับ nextPageToken ให้ใช้ค่านั้นในพารามิเตอร์ pageToken ของคําขอต่อไปเพื่อดึงหน้าถัดไปสำหรับข้อมูลเพิ่มเติม ดู การจัดหน้า

หากจํานวนผลลัพธ์เป็นหมายเลขที่แบ่งได้โดย maxPageSize (ตัวอย่างเช่นคุณมีผลลัพธ์ 50 และ maxPageSize ของ 25) คุณอาจพบสถานการณ์ที่การตอบสนองของคุณรวมถึงค่าสําหรับ nextPageToken แต่คําขอที่ใช้โทเค็นนั้นไม่มีผลลัพธ์:

GET /cloud/v2/users/{userId}/inventory-items?maxPageSize=25&pageToken=cccDDD
{
    "inventoryItems": [],
    "nextPageToken": ""
}

เมื่อใช้การจัดเรียงหน้าในแอปของคุณ การปฏิบัติที่ดีที่สุดคือการตรวจสอบไม่เพียงแค่สําหรับช่องว่างไม่เปล่า nextPageToken แต่ยังสําหรับช่องว่างไม่เปล่า inventoryItems ด้วย