O caminho de recursos do item do inventário.
Formato: users/{user_id}/inventory-items/{inventory_item_id}.
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
InventoryItem
Representa um item no inventário de um usuário.
Atributos
Um dos seguintes para details:
Populado se este item for um ativo.
Populado se este item for uma emblema.
Populado se este item for um passe de jogo.
Populado se este item for um servidor privado.
O momento em que o item foi adicionado ao inventário do usuário. Por exemplo, o momento em que o usuário comprou um servidor privado ou recebeu um emblema.
Este campo não está atualmente preenchido para passes. Esta cadeia de caracteres é formatada como um Timestamp.
URL base
https://apis.roblox.comO 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
GET /cloud/v2/users/{user_id}/inventory-items
Liste os itens de inventário em um inventário de um usuário.
Os itens de inventário retornados dependem da escolha do usuário alvo sob Configurações > Privacidade > Quem pode ver meu inventário? :
- Se o usuário concedeu visibilidade de inventário a "Todos", então qualquer chave de API ou token de OAuth2 pode ser usada para ver o inventário do alvo, não importa quais scopes ele tenha ou quem o criou.
- Se o usuário não concedeu visibilidade de inventário a "Todos":
- Seu inventário ainda pode ser visto com uma chave de API criada pelo usuário alvo com permissão Inventário: Leia .
- Seu inventário ainda pode ser visto com um token de OAuth2 se o usuário alvo autorizar um aplicativo solicitando permissões para o escopo user.inventory-item:read.
Limites de Velocidade:
- Chaves de API - 100 solicitações/minuto por proprietário de chave de API (pode ser usuário ou grupo). Limites de taxa são aplicados a todas as chaves de API de um Proprietário.
- Tokens de OAuth2 - 20 solicitações/minuto por token de acesso OAuth2
O ID do usuário.
O número máximo de itens de inventário a retornar.O serviço pode retornar menos que esse valor.Se não especificado, no máximo 10 itens de inventário são retornados.O valor máximo é 100 e valores mais altos são definidos como 100.
Um token de página, recebido de uma chamada anterior, para recuperar uma página posterior.
Ao paginar, todos os outros parâmetros fornecidos à chamada posterior devem corresponder à chamada que forneceu o token da página.
Este campo pode ser definido para filtrar os recursos retornados.
Veja a documentação de filtragem para mais informações.
RespostainventoryItemsarray<InventoryItem> nextPageTokenstring
Uma lista de Itens de Inventário na coleçõespai.
Os Itens de Inventário do Usuárioespecificado.
Um token que você pode enviar como um parâmetro pageToken para recuperar a próxima página. Se este campo for omitido, não há páginas subsequentes.
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}'Resposta
{
"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"
}