*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

InventoryItem

Rappresenta un oggetto nell'inventario di un utente.

Attributi

pathstring

Il percorso risorsa dell'elemento inventario.

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

Uno dei seguenti per details:

assetDetailsobject

Popolato se questo oggetto è un'asset.

badgeDetailsobject

Popolato se questo oggetto è un badge.

gamePassDetailsobject

Popolato se questo oggetto è un game pass.

privateServerDetailsobject

Popolato se questo oggetto è un server privato.

addTimestring
Solo output

Il momento in cui l'elemento è stato aggiunto all'inventario dell'utente. Ad esempio, il momento in cui l'utente ha acquistato un server privato o è stato premiato con un badge.

Questo campo non è attualmente popolato per i pass. Questa stringa è formattata come Timestamp.

URL di base
https://apis.roblox.com
Risorsa 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

Elenca gli articoli dell'inventario
Beta

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

Elenca gli oggetti dell'inventario nell'inventario di un utente.

Gli oggetti inventari restituiti dipendono dalla scelta dell'utente target sotto Impostazioni > Privacy > Chi può vedere il mio inventario? :

  • Se l'utente ha concesso visibilità dell'inventario a "Tutti", qualsiasi chiave API o token OAuth2 può essere utilizzato per visualizzare l'inventario del destinatario, indipendentemente da quali scope abbia o da chi lo abbia creato.
  • Se l'utente non ha concesso visibilità inventario a "Tutti":
    • Il loro inventario può ancora essere visualizzato con una chiave API creata dall'utente target con l'autorizzazione Inventario: Leggi .
    • Il loro inventario può ancora essere visualizzato con un token OAuth2 se l'utente target autorizza una richiesta di app che richiede permessi per lo scope user.inventory-item:read .

Limiti di tasso:

  • Chiavi API - 100 richieste/minuto per ogni proprietario di chiave API (può essere utente o gruppo). I limiti di tariffa sono applicati a tutte le chiavi API di un proprietario.
  • Token OAuth2 - 20 richieste/minuto per il token di accesso OAuth2
RichiestaParametri percorso
user_idstring
Necessario

L'ID utente.

Parametri query
maxPageSizenumber

Il numero massimo di oggetti inventario da restituire.Il servizio potrebbe restituire meno di questo valore.Se non specificato, vengono restituiti al massimo 10 oggetti inventario.Il valore massimo è 100 e i valori più alti sono impostati su 100.

pageTokenstring

Un token di pagina, ricevuto da una chiamata precedente, per recuperare una pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti alla chiamata successiva devono corrispondere alla chiamata che ha fornito il token della pagina.

filterstring

Questo campo può essere impostato per filtrare le risorse restituite.

Vedi la documentazione filtraggio per ulteriori informazioni.

Risposta

Un elenco di oggetti inventario nella collezione padre.

inventoryItemsarray<InventoryItem>

Gli InventoryItems dall'utente specificato.

nextPageTokenstring

Un token che puoi inviare come parametro pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.

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

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

}