# 撤回物品库商品

撤销对多个用户的商品访问权限。

注意： 一次只能处理50个操作。超出此限制的操作将被忽略。

Endpoint: POST /v2/project/{project_id}/inventory/revoke
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    项目ID。

## Request fields (application/json):

  - `comment` (string)
    操作说明。例如：“商品已转移给另一个玩家”。

  - `items` (array, required)

  - `items.quantity` (integer, required)
    需要撤销的此类商品数。

  - `items.sku` (string, required)
    唯一商品ID。 SKU只能包含大小写英文字母和数字字符、句点、破折号和下划线。

  - `platform` (string)
    用户玩游戏的发布平台。
    Enum: "playstation_network", "xbox_live", "xsolla", "pc_standalone", "nintendo_shop", "google_play", "app_store_ios", "android_standalone", "ios_standalone", "android_other", "ios_other", "pc_other"

  - `user` (object, required)

  - `user.id` (string)
    平台上的唯一用户标识符。

## Response 200 fields (application/json):

  - `count` (integer)
    成功撤回其商品的用户数量。
    Example: 10

  - `operations` (array)
    操作说明。

  - `operations.comment` (string)
    操作说明。例如：“商品已转移给另一个玩家”。
    Example: "Some comment for this operation"

  - `operations.items` (array)
    此操作中的商品。

  - `operations.items.balance` (integer)
    用户拥有的此类商品总数。
    Example: 1

  - `operations.items.quantity` (integer)
    已撤销的此类商品数。
    Example: 1

  - `operations.items.sku` (string)
    商品类标识符。SKU只能包含小写英文字母、数字字符、句点、破折号和下划线。
    Example: "com.xsolla.item_1"

  - `operations.platform` (string)
    Enum: "playstation_network", "xbox_live", "xsolla", "pc_standalone", "nintendo_shop", "google_play", "app_store_ios", "android_standalone", "ios_standalone", "android_other", "ios_other", "pc_other"

  - `operations.user_id` (string)
    平台上的唯一用户标识符。
    Example: "d.user"

## Response 404 fields (application/json):

  - `errorCode` (integer)
    错误代码。
    Example: 4001

  - `errorMessage` (string)
    错误消息。
    Example: "[0401-5004]: Could not find instance in inventory: Could not remove 10, user only has 1"

  - `statusCode` (integer)
    Example: 404