Skip to main content
Version: SDK-5.11.2

UseGoodsV4

public BackendReturnObject UseGoodsV4(goodsType type, int amount);

Note

This method allows the use of goods only outside the period of 4-5 am daily to prevent ranking settlement errors.
If rankings using goods are not included, please use ContributeGoodsV3, which does not have such restrictions.

Parameters

ValueTypeDescription
typegoodsType(enum)Type of currency to contribute. goodsType.goodsN(N: 1 - 10)
amountintAmount to be used. Only negative numbers are allowed.

Description

Uses the currency of the guild's goodsType.

Making changes between 4 - 5 am is unavailable, and requesting a change will return a 428 error.

It is used in the same way as UseGoodsV3.

When the ContributeGoodsV3 method is called while updating rankings using goods information, the ranking settlement process may fail with a low probability. Therefore, it is recommended to migrate to the ContrivuteGoodsV4 method to restrict updates during settlement time.

Example

Synchronous

Backend.Guild.UseGoodsV4(goodsType.goods1, -20);

Asynchronous

Backend.Guild.UseGoodsV4(goodsType.goods1, -10, (callback) => 
{
// Post-process
});

SendQueue

SendQueue.Enqueue(Backend.Guild.UseGoodsV4, goodsType.goods1, -10, (callback) => 
{
// Post-process
});

Return cases

Success cases

When used
statusCode : 204
message : Success

Error cases

When a guild member who is not the master attempts to use
statusCode : 403
errorCode : ForbiddenException
message : Forbidden useGoods, Cannot use goods

When the amount is a positive number
statusCode : 412
errorCode : PreconditionFailed
message : type prerequisites are not met.

When the used amount is larger than the owned amount
statusCode : 412
errorCode : PreconditionFailed
message : inadequateAmount prerequisites are not met.

When a person not in the guild attempts to use
statusCode : 412
errorCode : PreconditionFailed
message : notGuildMember prerequisites are not met.

When called between 4 - 5 am
statusCode : 428
errorCode : Precondition Required
message : Precondition Required ranking is being counted