본문으로 건너뛰기
버전: SDK-5.11.5

CreateGuildV3

public BackendReturnObject CreateGuildV3(string guildName, int goodsCount);
public BackendReturnObject CreateGuildV3(string guildName, int goodsCount, CountryCode countryCode);
public BackendReturnObject CreateGuildV3(string guildName, int goodsCount, Param param);
public BackendReturnObject CreateGuildV3(string guildName, int goodsCount, Param param, CountryCode countryCode);

파라미터

ValueTypeDescriptiondefault
guildNamestring길드 이름-
goodsCountint사용할 길드 재화의 개수(1~10)(길드 생성 이후 수정 불가)-
paramParam(Optional) 길드에 관한 메타정보-
countryCodeCountryCode(Optional) 국가 정보CountryCode.NONE

설명

길드를 생성합니다.

  • 뒤끝 콘솔에서 등록한 길드 생성 조건에 모두 만족하는 회원만이 길드 생성이 가능합니다.

    길드 생성 조건의 기준은 뒤끝 콘솔 > 뒤끝베이스 > 길드 관리 > 설정에서 지정한 테이블, 지정한 파티션의 가장 최신 값으로 판단합니다.
    뒤끝 콘솔에 등록한 길드 생성 조건이 없으면 모든 회원이 길드 생성이 가능합니다.

주의
  • 길드명은 최소 2자 - 최대 16자이며, 한글, 영문, 숫자 사용 가능하며 특수문자는 불가능합니다.
  • 또한 숫자로 시작할 수 없으며, 공백은 가능하나 연속 입력 불가, 공백으로 시작하거나 끝날 수 없습니다.
  • 길드 굿즈 종류의 개수는 생성시에만 정할 수 있으며 이후 종류의 개수를 줄이거나 늘리는 등의 변경은 불가능합니다.
  • 메타정보는 원하는 정보를 저장할 수 있으며, ModifyGuild(Param)을 통해서 메타정보를 추가/수정 가능합니다.
  • 국가 코드는 길드 생성 이후 길드 마스터가 UpdateCountryCode를 사용하여 추가/수정할 수 있습니다.
  • CountryCode에 대한 정보는 이곳을 참고해 주세요.
  • 반드시 유저들의 국가 코드에 존재하는 국가만 길드의 국가 코드에 등록해야 합니다.
  • 유저들의 국가 코드 풀에 해당하지 않는 길드의 국가 코드는 콘솔에서 표시되지 않습니다.

Example

동기

// 메타정보가 없는 경우
Backend.Guild.CreateGuildV3("guildName", 2);

Backend.Guild.CreateGuildV3("guildName", 2, CountryCode.SouthKorea);

// param에 원하는 메타정보를 입력(Optional)
Param param = new Param();
param.Add("level",0);
param.Add("buf",1);

Backend.Guild.CreateGuildV3("guildName", 2, param);

Backend.Guild.CreateGuildV3("guildName", 2, param, CountryCode.SouthKorea);

비동기

// 메타정보가 없는 경우
Backend.Guild.CreateGuildV3("guildName", 2, (callback) =>
{
// 이후 처리
});

Backend.Guild.CreateGuildV3("guildName", 2, CountryCode.SouthKorea, (callback) =>
{
// 이후 처리
});

// 메타정보가 있는 경우
Param param = new Param();
param.Add("level",0);
param.Add("buf",1);

Backend.Guild.CreateGuildV3("guildName", 2, param, (callback) =>
{
// 이후 처리
});

Backend.Guild.CreateGuildV3("guildName", 2, param, CountryCode.SouthKorea, (callback) =>
{
// 이후 처리
});

SendQueue

//메타정보가 없는 경우
SendQueue.Enqueue(Backend.Guild.CreateGuildV3("guildName", 2, (callback) =>
{
// 이후 처리
});

Backend.Guild.CreateGuildV3("guildName", 2, CountryCode.SouthKorea, (callback) =>
{
// 이후 처리
});

//메타정보가 있는 경우
Param param = new Param();
param.Add("level",0);
param.Add("buf",1);

Backend.Guild.CreateGuildV3("guildName", 2, param, (callback) =>
{
// 이후 처리
});

Backend.Guild.CreateGuildV3("guildName", 2, param, CountryCode.SouthKorea, (callback) =>
{
// 이후 처리
});

ReturnCase

Success cases

생성에 성공한 경우
statusCode : 204
message : Success

Error cases

goodsCount가 10 이상인 경우
statusCode : 400
errorCode : BadParameterException
message : bad goodsCount is too big, 잘못된 goodsCount is too big 입니다

goodsCount가 0이하인 경우
statusCode : 400
errorCode : UndefinedParameterException
message : undefined goodsCount must be more then 1, goodsCount must be more then 1을(를) 확인할 수 없습니다

콘솔 설정 조건에 맞지 않는 유저가 길드 생성 시도한 경우
statusCode : 403
errorCode : ForbiddenError
message : Forbidden createGuild, 금지된 createGuild

중복된 길드명으로 생성 시도한 경우
statusCode : 409
errorCode : DuplicatedParameterException
message : Duplicated guildName, 중복된 guildName 입니다

길드명 조건이 맞지 않는 경우
statusCode : 412
errorCode : PreconditionFailed
message : guildName 사전 조건을 만족하지 않습니다

이미 속해있는 길드가 존재하는 경우
statusCode : 412
errorCode : PreconditionFailed
message : JoinedGamer 사전 조건을 만족하지 않습니다