*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

InventoryItem

Mewakili item di inventaris pengguna.

Atribut

pathstring

Jalur sumber daya dari item inventaris.

Format: users/{user_id}/inventory-items/{inventory_item_id}.

Salah satu dari yang berikut untuk details:

assetDetailsobject

Dipenuhi jika item ini adalah aset.

badgeDetailsobject

Dipenuhi jika item ini adalah lencana.

gamePassDetailsobject

Dipenuhi jika item ini adalah pas permainan.

privateServerDetailsobject

Dipenuhi jika item ini adalah server pribadi.

addTimestring
Hanya Output

Waktu ketika item ditambahkan ke inventaris pengguna. Misalnya, waktu ketika pengguna membeli server pribadi atau diberikan lencana.

Bidang ini saat ini tidak dipenuhi untuk pas. String ini diformat sebagai Timestamp.

Base URL
https://apis.roblox.com
Resource 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

Daftar item inventaris di inventaris pengguna.

Item inventaris yang dikembalikan tergantung pada pilihan pengguna target di bawah Pengaturan > Privasi > Siapa yang dapat melihat inventaris saya? :

  • Jika pengguna memberikan visibilitas inventaris ke "Semua orang," maka kunci API atau token OAuth2 apa pun dapat digunakan untuk melihat inventaris target, tidak peduli apa jangkauannya atau siapa yang membuatnya.
  • Jika pengguna belum memberikan visibilitas inventaris ke "Semua orang":
    • Inventaris mereka masih dapat dilihat dengan kunci API yang dibuat oleh pengguna target dengan izin Inventaris: Baca .
    • Inventaris mereka masih dapat dilihat dengan token OAuth2 jika pengguna target mengotorisasi permintaan aplikasi yang meminta izin untuk scope user.inventory-item:read .

Batas Tingkat:

  • Kunci API - 100 permintaan/menit per pemilik kunci API (dapat menjadi pengguna atau grup). Batas tarif diterapkan di semua kunci API pemilik.
  • Token OAuth2 - 20 permintaan/menit untuk token akses OAuth2
PermintaanParameter Jalur
user_idstring
Diperlukan

ID pengguna.

Parameter Kueri
maxPageSizenumber

Jumlah maksimum item inventaris untuk dikembalikan.Layanan mungkin kembali kurang dari nilai ini.Jika tidak ditentukan, paling banyak 10 item inventaris dikembalikan.Nilai maksimum adalah 100 dan nilai yang lebih tinggi ditetapkan ke 100.

pageTokenstring

Token halaman, diterima dari panggilan sebelumnya, untuk mengambil halaman berikutnya.

Saat paginasi, semua parameter lain yang disediakan untuk panggilan berikutnya harus cocok dengan panggilan yang memberikan token halaman.

filterstring

Bidang ini dapat ditetapkan untuk memfilter sumber daya yang dikembalikan.

Lihat dokumentasi filtrasi untuk informasi lebih lanjut.

Respons

Daftar Item Inventaris di koleksi orang tua.

inventoryItemsarray<InventoryItem>

Item Inventaris dari Pengguna yang ditentukan.

nextPageTokenstring

Token yang dapat Anda kirim sebagai parameter pageToken untuk mengambil halaman berikutnya. Jika bidang ini diabaikan, tidak ada halaman berikutnya.

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}'
Respons
{

  "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"

}