Create Guild

Creates a guild.

Check URL

This API uses the service-api.playnanoo.com domain.

API Information

• URL: https://service-api.playnanoo.com/guild/v20230101/create
• Method: PUT
• Authentication Required: Yes

Request Parameters

Parameter	Type	Required	Description
table_code	string	Required	Table code
name	string	Required	Guild name
member_limit	int	Required	Member limit
member_point_type	string	Required	Member point type (keep: keep points, delete: deduct points)
auto_join	string	Required	Auto-join option (Y/N)
extra_data	string	Yes	Additional data

PlayerInfo Inheritance

The Req structure of this API includes PlayerInfo properties.

Response Data

Res Class

Field	Type	Description
Uid	string	Guild unique ID
Name	string	Guild name

Code Example

void UMyGame::CreateGuild(const FString& TableCode, const FString& GuildName, int32 MemberLimit, const FString& MemberPointType, bool bAutoJoin, const FString& ExtraData)
{
    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("table_code"), TableCode);
    Body->SetStringField(TEXT("name"), GuildName);
    Body->SetNumberField(TEXT("member_limit"), MemberLimit);
    Body->SetStringField(TEXT("member_point_type"), MemberPointType);
    Body->SetStringField(TEXT("auto_join"), bAutoJoin ? TEXT("Y") : TEXT("N"));
    if (!ExtraData.IsEmpty())
    {
        Body->SetStringField(TEXT("extra_data"), ExtraData);
    }

    // JSON 문자열 변환
    FString JsonBody = FPlayNANOOHelper::ToJsonString(Body);

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-api.playnanoo.com/guild/v20230101/create"));
    Request->SetVerb(TEXT("PUT"));
    FPlayNANOOHelper::SetCommonHeaders(Request, true);  // 인증 토큰 포함
    Request->SetContentAsString(JsonBody);

    Request->OnProcessRequestComplete().BindLambda(
        [](FHttpRequestPtr Req, FHttpResponsePtr Res, bool bSuccess)
    {
        if (bSuccess && Res.IsValid())
        {
            TSharedPtr<FJsonObject> JsonObject;
            TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(Res->GetContentAsString());

            if (FJsonSerializer::Deserialize(Reader, JsonObject))
            {
                FString Uid = JsonObject->GetStringField(TEXT("Uid"));
                FString Name = JsonObject->GetStringField(TEXT("Name"));

                UE_LOG(LogTemp, Log, TEXT("길드 생성 성공!"));
                UE_LOG(LogTemp, Log, TEXT("Guild UID: %s"), *Uid);
                UE_LOG(LogTemp, Log, TEXT("Guild Name: %s"), *Name);
            }
        }
    });

    Request->ProcessRequest();
}

Authentication Required

This API requires Bearer token authentication. You must first log in to obtain an access token.

Point Type Options

The member_point_type parameter determines how points are handled when a guild member leaves:

• "keep": Keep points - the guild's total points remain even when members leave
• "delete": Deduct points - the member's points are deducted from the guild when they leave

Auto-Join Options

The auto_join parameter determines how guild join requests are processed:

• "Y": Join requests are automatically approved
• "N": Guild master or administrators must manually approve join requests