Unlock Container Item
NOTE: This is a Legacy Economy API, and is in bugfix-only mode. All new Economy features are being developed only for version 2. Searches target inventory for an ItemInstance matching the given CatalogItemId, if necessary unlocks it using an appropriate key, and returns the contents of the opened container. If the container (and key when relevant) are consumable (RemainingUses > 0), their RemainingUses will be decremented, consistent with the operation of ConsumeItem.
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| CharacterNotFound | 1135 |
| ContainerKeyInvalid | 1205 |
| ContainerNotOwned | 1018 |
| InvalidContainerItem | 1017 |
| InvalidItemIdInTable | 1020 |
| InvalidItemProperties | 1091 |
| KeyNotOwned | 1019 |
| ProductDisabledForTitle | 1609 |
Authorizations
This API requires a client session ticket, available from any Client Login function.
Body
Specify the type of container to open and optionally the catalogVersion for the container to open
Specify the type of container to open and optionally the catalogVersion for the container to open
Catalog ItemId of the container type to unlock.
Specifies the catalog version that should be used to determine container contents. If unspecified, uses default/primary catalog.
Unique PlayFab assigned ID for a specific character owned by a user
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
Response
The items and vc found within the container. These will be added and stacked in the appropriate inventory.
