*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

InventoryItem

Vertreibt ein Element im Inventar eines Benutzers.

Attribute

pathstring

Der Ressourcenpfad des Inventarartikels.

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

Eins der folgenden für details:

assetDetailsobject

Bevölkert, wenn dieses Element ein Objektist.

badgeDetailsobject

Bevölkerung, wenn dieses Element ein Abzeichen ist.

gamePassDetailsobject

Bevölkerung, wenn dieses Element ein Passist.

privateServerDetailsobject

Bevölkert, wenn dieses Element ein privater Server ist.

addTimestring
Nur Ausgabe

Die Zeit, in der das Element zum Inventar des Benutzers hinzugefügt wurde. Zum Beispiel die Zeit, in der der Benutzer einen privaten Server gekauft oder ein Abzeichen erhalten hat.

Dieses Feld ist derzeit nicht für Pässe ausgefüllt. Dieser String ist als Zeitstempel formatiert.

Basis-URL
https://apis.roblox.com
Die InventoryItem-Ressource
{

  "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

Liste die Inventarartikel im Inventar eines Benutzers auf.

Die zurückgegebenen Inventarartikel hängen von der Wahl des Zielbenutzers unter Einstellungen > Datenschutz > Wer kann mein Inventar sehen? ab:

  • Wenn der Benutzer der Inventarisvisibilität zu "Jedem" gewährt, kann jede API-Schlüssel oder OAuth2-Token verwendet werden, um das Inventar des Ziels anzuzeigen, unabhängig davon, welche Bereiche es hat oder wer es erstellt hat.
  • Wenn der Benutzer der Inventarisvisibilität für "Alle" nicht zugestimmt hat:
    • Ihr Inventar kann immer noch mit einem von der Zielperson mit Inventar: Lesen bereitgestellten API-Schlüssel angesehen werden.
    • Ihr Inventar kann immer noch mit einem OAuth2-Token angesehen werden, wenn der anvisierte Benutzer eine App autorisiert, die Berechtigungen für den user.inventory-item:read Bereich beantragt.

Begrenzungen der Rate:

  • API-Schlüssel - 100 Anfragen pro Minute pro API-Schlüsselbesitzer (kann Benutzer oder Gruppe sein). Die Rategrenzen werden für alle API-Schlüssel eines Eigentümerdurchgesetzt.
  • OAuth2-Token - 20 Anfragen/Minute pro OAuth2-Zugriffs token
AnfragePfadparameter
user_idstring
Erforderlich

Die Benutzer-ID.

Anfrageparameter
maxPageSizenumber

Die maximale Anzahl der Inventarartikel, die zurückgegeben werden.Der Dienst könnte weniger als diesen Wert zurückgeben.Wenn nicht spezifiziert, werden höchstens 10 Inventarartikel zurückgegeben.Der maximale Wert beträgt 100, und höhere Werte werden auf 100 festgelegt.

pageTokenstring

Ein Seiten-Token, das von einer früheren Anruf erhalten wurde, um eine nachfolgende Seite abzurufen.

Wenn Seiten nummeriert werden, müssen alle anderen Parameter, die der nachfolgenden Anruf bereitgestellt hat, dem Anruf entsprechen, der das Seiten-Token bereitgestellt hat.

filterstring

Dieses Feld kann festgelegt werden, um die zurückgegebenen Ressourcen zu filtern.

Siehe die Filterung-Dokumentation für weitere Informationen.

Rückmeldung

Eine Liste von Inventarartikeln in der übergeordneten Sammlungen.

inventoryItemsarray<InventoryItem>

Die Inventarartikel vom angegebenen Benutzer.

nextPageTokenstring

Ein Token, das du als pageToken-Parameter senden kannst, um die nächste Seite abzurufen. Wenn dieses Feld ausgelassen wird, gibt es keine nachfolgenden Seiten.

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}'
Rückmeldung
{

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

}