Envanter öğesinin kaynak yolu.
Biçim: users/{user_id}/inventory-items/{inventory_item_id}.
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
InventoryItem
Bir kullanıcının envanterinde bir öğeyi temsil eder.
Nitelikler
details için şunlardan biri:
Bu öğe bir varlık ise doldurulur.
Bu öğe bir rozet ise doldurulur.
Bu öğe bir oyun biletdoldurulur.
Bu öğe özel bir sunucuysa doldurulur.
Öğe, kullanıcının envanterine eklenen zaman. Örneğin, kullanıcı özel bir sunucu satın aldı veya bir rozet aldığında zaman.
Bu alan şu anda geçişler için doldurulmadı. Bu dizi Timestamp olarak biçimlendirilmiş.
Taban URL
https://apis.roblox.comInventoryItem Kaynağı
{
"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
Kullanıcının envanterinde envanter öğelerini listeleyin.
Geri dönen envanter öğeleri, hedef kullanıcının Ayarlar > Gizlilik > Envanterimi kim görebilir? altındaki seçimine bağlıdır:
- Kullanıcı envanter görünürlüğünü "Herkese" verdiyse, hedefin envanterini görmek için herhangi bir API anahtarı veya OAuth2 jetonu kullanılabilir, ne alanı varsa veya kim oluşturduysa.
- Kullanıcı "Herkese" envanter görünürlüğü vermediyse:
- Envanterleri, hedef kullanıcı tarafından Envanter: Oku izni ile oluşturulan bir API anahtarı ile hala görülebilir.
- Hedef kullanıcı, user.inventory-item:read alanı için izin isteyen bir uygulama talebini yetkilendirirse envanterleri hala bir OAuth2 jetonu ile görülebilir.
Oran Sınırları:
- API Anahtarları - API anahtar sahibi başına dakika başına 100 istek (kullanıcı veya grup olabilir). Oran sınırları tüm bir sahibin API anahtarları arasında uygulanır.
- OAuth2 Jetonları - OAuth2 erişim jetonu başına dakika başına 20 istek
Kullanıcı kimliği.
Geri döndürülecek en fazla envanter öğesi sayısı.Hizmet bu değerden daha azını iade edebilir.Belirtilmediğinde, en fazla 10 envanter öğesi döndürülür.Maksimum değer 100'dür ve daha yüksek değerler 100 olarak ayarlanır.
Bir önceki çağrıdan alınan bir sayfa jetonu, sonraki bir sayfa almak için.
Sayfa numaralandırırken, sonraki çağrıya verilen tüm diğer parametler, sayfa jetonu sağlayan çağrıya eşleşmelidir.
Bu alan, döndürülen kaynakları filtrelemek için ayarlanabilir.
Daha fazla bilgi için filtreleme dokümanına bakın.
YanıtinventoryItemsarray<InventoryItem> nextPageTokenstring
Ebeveyn koleksiyonundaki EnvanterÖğelerinin bir listesi.
Belirtilen Kullanıcıdan EnvanterÖğeleri.
Bir sonraki sayfayı almak için bir pageToken çözümleyici olarak gönderebileceğiniz bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.
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}'Yanıt
{
"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"
}