본문으로 건너뛰기
버전: 5.14.1

ContributeGuildGoods

public BackendReturnObject ContributeGuildGoods(string rankUuid, goodsType goodsType, int value);

안내

구버전 랭킹은 해당 함수를 이용할 수 없습니다.

파라미터

ValueTypeDescription
rankUuidstring갱신할 랭킹의 uuid
goodsTypegoodsType갱신할 길드 굿즈 타입
valueint기부할 값

rankUuid 값은 아래 방법을 통해 확인할 수 있습니다.

설명

길드에 굿즈를 기부함과 동시에 랭킹을 갱신합니다.

  • ContributeGuildGoods 함수는 Backend.Social.Guild.ContributeGoodsV3 함수에 랭킹 갱신 기능이 추가된 함수입니다.
  • ContributeGuildGoods 함수 혹은 UseGuildGoods 함수를 이용하지 않고 갱신된 굿즈 내역은 랭킹에 반영되지 않습니다.

    현재 랭킹에 10000점이 반영되어 있는 상태에서 Backend.Social.Guild.ContributeGoodsV3 함수를 이용하여 1000점을 기부한 경우 랭킹에는 10000점, 길드 굿즈에는 11000점이 반영되게 됩니다.

여기서 다시 ContributeGuildGoods 함수를 이용하여 1000점을 기부한 경우 랭킹에는 12000점, 길드 굿즈에도 12000점이 반영되게 됩니다.

길드 랭킹은 추가 항목을 지원하지 않습니다.

Example

동기

Backend.URank.Guild.ContributeGuildGoods("rankUuid", goodsType.goods1, 1);

비동기

Backend.URank.Guild.ContributeGuildGoods("rankUuid", goodsType.goods1, 1, callback => {
// 이후 처리
});

SendQueue

SendQueue.Enqueue(Backend.URank.Guild.ContributeGuildGoods, "rankUuid", goodsType.goods1, 1, callback => {
// 이후 처리
});

ReturnCase

Success cases

갱신에 성공한 경우
statusCode : 204
message : Success

Error cases

uuid가 null 혹은 string.Empty인 경우
statusCode : 400
errorCode : ValidationException
message : rankUuid is null or empty

갱신을 시도한 랭킹이 굿즈 랭킹이 아닌 경우
statusCode : 400
errorCode : BadParameterException
message : bad table, 잘못된 table 입니다

value가 0 이하인 경우
statusCode : 400
errorCode : PreconditionFailed
message : value only allow more than 0

랭킹을 생성할 때 선택하지 않은 굿즈로 갱신을 시도한 경우
statusCode : 404
errorCode : NotFoundException
message : guild rank not found, guild rank을(를) 찾을 수 없습니다

가입한 길드가 없는 유저가 랭킹 갱신을 시도한 경우
statusCode : 412
errorCode : PreconditionFailed
message : notGuildMember 사전 조건을 만족하지 않습니다.

UTC+9 04:00 ~ 05:00 사이에 랭킹 갱신을 시도한 경우
statusCode : 428
errorCode : Precondition Required
message : Precondition Required ranking is being counted

한국 시간으로 새벽 4시 ~ 5시 사이 랭킹 갱신을 시도한 경우

기간이 끝난 일회성 랭킹의 갱신을 시도한 경우
statusCode : 428
errorCode : Precondition Required
message : Precondition Required ranking is being counted