*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 ekwipunku uż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 odznaką.

gamePassDetailsobject

Wypełnione, jeśli ten przedmiot jest przepustką gry.

privateServerDetailsobject

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

addTimestring
Tylko dane wyjściowe

Czas, kiedy przedmiot został dodany do zapasu użytkownika. Na przykład czas, kiedy użytkownik kupił prywatny serwer lub otrzymał odznakę.

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

Wyświetl przedmioty ekwipunku
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 ekwipunek? :

  • Jeśli użytkownik przyznał widoczność zapasu do "Wszystkich", każdy klucz API lub token OAuth2 może być użyty do wyświetlenia zapasu celu, 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
Limity
  • Klucze API: Liczba żądań na minutę dla wszystkich kluczy interfejsu API na użytkownika lub grupę: 100
  • OAuth 2.0: Liczba żądań na minutę na każdego użytkownika aplikacji: 20

Uwaga: limity częstotliwości wysyłania żądań mogą być niższe w okresach dużego ruchu. Niektóre punkty końcowe mają dodatkowe limity częstotliwości wysyłania żądań. Więcej informacji o limitach częstotliwości wysyłania żądań.

Żą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 kolekcji macierzystej.

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"

}