*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

InventoryItem

Representa un artículo en el inventario de un usuario.

Atributos

pathstring

El camino de recursos del objetodel inventario.

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

Uno de los siguientes para details:

assetDetailsobject

Se pobló si este artículo es un activo.

badgeDetailsobject

Se pobló si este artículo es una emblema.

gamePassDetailsobject

Se pobló si este artículo es un pase de juego.

privateServerDetailsobject

Se pobló si este artículo es un servidor privado.

addTimestring
Solo salida

El momento en que se agregó el artículo al inventario del usuario. Por ejemplo, el momento en que el usuario compró un servidor privado o recibió una emblema.

Este campo no está actualmente poblado para pases. Esta cadena está formateada como Timestamp.

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

Lista los artículos del inventario en el inventario de un usuario.

Los elementos del inventario devueltos dependen de la elección del usuario objetivo bajo Configuración > Privacidad > ¿Quién puede ver mi inventario? :

  • Si el usuario otorgó visibilidad de inventario a "Todos", entonces cualquier clave de API o token de OAuth2 se puede usar para ver el inventario del destinatario, sin importar qué alcances tiene o quién lo creó.
  • Si el usuario no ha otorgado visibilidad de inventario a "Todos":
    • Su inventario aún se puede ver con una clave API creada por el usuario objetivo con el permiso Inventario: Leer .
    • Su inventario aún se puede ver con un token de OAuth2 si el usuario objetivo autoriza una solicitud de aplicación que solicita permisos para el alcance user.inventory-item:read .

Límites de tasa:

  • Claves API - 100 solicitudes/minuto por propietario de clave API (puede ser usuario o grupo). Los límites de tasa se aplican a todas las claves API de un propietario.
  • Fichas de OAuth2 - 20 solicitudes/minuto por token de acceso de OAuth2
SolicitudParámetros de ruta
user_idstring
Obligatorio

La identificación del usuario.

Parámetros de consulta
maxPageSizenumber

El número máximo de artículos de inventario para devolver.El servicio podría devolver menos que este valor.Si no se especifica, se devuelven un máximo de 10 artículos de inventario.El valor máximo es 100 y los valores más altos se establecen en 100.

pageTokenstring

Una ficha de página, recibida de una llamada anterior, para recuperar una página posterior.

Al paginar, todos los demás parámetros proporcionados a la llamada siguiente deben coincidir con la llamada que proporcionó el token de página.

filterstring

Este campo se puede configurar para filtrar los recursos devueltos.

Consulte la documentación de filtrado para obtener más información.

Respuesta

Una lista de artículos de inventario en la coleccionespadre.

inventoryItemsarray<InventoryItem>

Los elementos de inventario del usuario especificado.

nextPageTokenstring

Una token que puedes enviar como parámetro pageToken para recuperar la siguiente página. Si este campo se omite, no hay páginas posteriores.

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

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

}