跳转到主要内容
POST
Modify Item Uses

授权

X-SecretKey
string
header
必填

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

请求体

application/json

This function can both add and remove uses of an inventory item. If the number of uses drops below zero, the item will be removed from active inventory.

This function can both add and remove uses of an inventory item. If the number of uses drops below zero, the item will be removed from active inventory.

ItemInstanceId
string
必填

Unique instance identifier of the item to be modified.

PlayFabId
string
必填

PlayFab unique identifier of the user whose item is being modified.

UsesToAdd
number
必填

Number of uses to add to the item. Can be negative to remove uses.

CustomTags
object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

响应

code
integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status
string

The Http status code as a string.

data
object
示例:
最后修改于 2026年10月6日