*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

InventoryItem

Représente un article dans l'inventaire d'un utilisateur.

Attributs

pathstring

Le chemin de ressource de l'itemd'inventaire.

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

Un des éléments suivants pour details:

assetDetailsobject

Populé si cet élément est une contenu.

badgeDetailsobject

Populé si cet élément est un badge.

gamePassDetailsobject

Populé si cet article est un passe de jeu.

privateServerDetailsobject

Populé si cet élément est un serveur privé.

addTimestring
Sortie seule

Le moment où l'élément a été ajouté à l'inventaire de l'utilisateur. Par exemple, le moment où l'utilisateur a acheté un serveur privé ou a reçu un badge.

Ce champ n'est pas actuellement rempli pour les passes. Ce string est formatée en tant que Timestamp.

URL de base
https://apis.roblox.com
La ressource 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
Bêta

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

Listez les articles de l'inventaire dans l'inventaire d'un utilisateur.

Les articles de l'inventaire renvoyés dépendent du choix de l'utilisateur cible sous Paramètres > Confidentialité > Qui peut voir mon inventaire ? :

  • Si l'utilisateur a accordé une visibilité d'inventaire à « Tout le monde », n'importe quelle clé API ou jeton OAuth2 peut être utilisée pour afficher l'inventaire de la cible, peu importe les domaines qu'elle a ou qui l'ont créée.
  • Si l'utilisateur n'a pas accordé de visibilité d'inventaire à « Tout le monde » :
    • Leur inventaire peut toujours être affiché avec une clé API créée par l'utilisateur cible avec l'autorisation Inventaire : Lire .
    • Leur inventaire peut toujours être affiché avec un jeton OAuth2 si l'utilisateur cible autorise une demande d'application demandant des permissions pour le scope user.inventory-item:read.

Limites de taux :

  • Clés API - 100 demandes/minute par propriétaire de clé API (peut être utilisateur ou groupe). Les limites de taux sont appliquées à toutes les clés API d'un propriétaire.
  • Jetons OAuth2 - 20 demandes/minute par jeton d'accès OAuth2
RequêteParamètres du chemin
user_idstring
Requis

L'ID utilisateur.

Paramètres de requête
maxPageSizenumber

Le nombre maximum d'éléments d'inventaire à renvoyer.Le service peut retourner moins que cette valeur.Si non spécifié, au maximum 10 articles d'inventaire sont retournés.La valeur maximale est de 100 et les valeurs plus élevées sont réglées sur 100.

pageTokenstring

Un jeton de page, reçu d'un appel précédent, pour récupérer une page suivante.

Lors de la pagination, tous les autres paramètres fournis à l'appel suivant doivent correspondre à l'appel qui a fourni le jeton de page.

filterstring

Ce champ peut être défini afin de filtrer les ressources renvoyées.

Voir la documentation filtrage pour plus d'informations.

Réponse

Une liste d'éléments d'inventaire dans la collectionsparent.

inventoryItemsarray<InventoryItem>

Les articles d'inventaire de l'utilisateur spécifié.

nextPageTokenstring

Un jeton que vous pouvez envoyer en tant que pageToken paramètre pour récupérer la page suivante. Si ce champ est omis, il n'y a pas de pages suivantes.

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éponse
{

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

}