*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

InventoryItem

Reprezentuje przedmiot w wyposażenieużytkownika.

Atrybuty

pathstring

Ścieżka zasobów przedmiotu ewidencji.

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

Jedna z następujących dla details:

assetDetailsobject

Wypełnione, jeśli ten przedmiot jest aktywem.

badgeDetailsobject

Wypełnione, jeśli ten przedmiot jest odznaka.

gamePassDetailsobject

Wypełnione, jeśli ten przedmiot jest przepustkagry.

privateServerDetailsobject

Wypełnione, jeśli ten przedmiot jest prywatnym serwerem.

addTimestring
Tylko dane wyjściowe

Czas, kiedy przedmiot został dodany do wyposażenieużytkownika. Na przykład czas, kiedy użytkownik kupił prywatny serwer lub otrzymał odznaka.

To pole nie jest obecnie wypełnione dla przepustek. Ten ciąg jest sformatowany jako Timestamp.

Podstawowy adres URL
https://apis.roblox.com
Zasób 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

Wyświetl elementy zapasu w zapasie użytkownika.

Przedmioty ewidencyjne zwracane zależą od wyboru użytkownika docelowego w ramach Ustawień > Prywatność > Kto może zobaczyć mój wyposażenie? :

  • Jeśli użytkownik przyznał widoczność zapasu do "Wszystkich", każdy klucz API lub token OAuth2 może być użyty do wyświetlenia wyposażeniecelu, bez względu na zakres, jaki ma lub kto go stworzył.
  • Jeśli użytkownik nie przyznał widoczności zapasu dla "Wszystkich":
    • Ich ekwipunek nadal można zobaczyć za pomocą klucza API utworzonego przez docelowego użytkownika z uprawnieniem Ekwipunek: Przeczytaj .
    • Ich ekwipunek nadal można zobaczyć za pomocą tokenu OAuth2, jeśli docelowy użytkownik upoważnia aplikację żądającą uprawnień dla zakresu user.inventory-item:read.

Ograniczenia stawki:

  • Klucze API - 100 żądań na minutę na każdego właściciela klucza API (może to być użytkownik lub grupa). Ograniczenia liczby żądań są egzekwowane na wszystkich kluczach API właściciela.
  • Tokeny OAuth2 - 20 żądań na minutę na temat tokenu dostępu OAuth2
ŻądanieParametry ścieżki
user_idstring
Wymagane

ID użytkownika.

Parametry zapytania
maxPageSizenumber

Maksymalna liczba przedmiotów ekwipunku do zwrotu.Usługa może zwrócić mniej niż tę wartość.Jeśli nie określono, zwracane jest maksymalnie 10 przedmiotów ekwipunku.Maksymalna wartość wynosi 100, a wyższe wartości są ustawione na 100.

pageTokenstring

Żeton strony, otrzymany z poprzedniego wezwania, aby odzyskać następną stronę.

Podczas paginowania wszystkie pozostałe parametry dostarczone do następnego wezwania muszą pasować do wezwania, które dostarczyło token strony.

filterstring

Pole to można ustawić w celu filtrowania zasobów zwrotnych.

Zobacz dokumentację filtrowania dla więcej informacji.

Odpowiedź:

Lista przedmiotów ekwipunku w kolekcjamacierzystej.

inventoryItemsarray<InventoryItem>

Przedmioty ekwipunku z określonego użytkownika.

nextPageTokenstring

Token, który możesz wysłać jako parametr pageToken w celu odzyskania następnej strony. Jeśli to pole zostanie pominięte, nie ma następnych stron.

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}'
Odpowiedź:
{

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

}