Kick Guild Member

Kicks (bans) a guild member.

Check URL

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

API Information

• URL: https://service-api.playnanoo.com/guild/v20230101/member/ban
• Method: PUT
• Authentication Required: Yes (Bearer Token)

Request Parameters

Parameter	Type	Required	Description
device_id	string	Required	Device ID
table_code	string	Required	Table code
uid	string	Required	Guild UID
member_uuid	string	Required	Member UUID to kick

Response Data

Kick Result

• ErrorCode: Error code (empty string on success)
• Message: Response message

Code Example

void UMyGame::BanGuildMember(const FString& DeviceId, const FString& TableCode, const FString& GuildUid, const FString& MemberUuid)
{
    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("device_id"), DeviceId);
    Body->SetStringField(TEXT("table_code"), TableCode);
    Body->SetStringField(TEXT("uid"), GuildUid);
    Body->SetStringField(TEXT("member_uuid"), MemberUuid);

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

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-api.playnanoo.com/guild/v20230101/member/ban"));
    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 Message = JsonObject->GetStringField(TEXT("Message"));
                UE_LOG(LogTemp, Log, TEXT("멤버 강퇴 성공!"));
                UE_LOG(LogTemp, Log, TEXT("Message: %s"), *Message);
            }
        }
    });

    Request->ProcessRequest();
}

Authentication Required

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

Permission Required

This API can only be called by guild masters or administrators. Regular members will receive a permission error.

Point Handling

Points from kicked members are handled according to the member_point_type set during guild creation:

• "keep": The guild's total points remain even when members are kicked
• "delete": The kicked member's points are deducted from the guild

Cannot Kick Guild Master

The guild master cannot be kicked. The master must first transfer their role to another member before they can be kicked.

Can Rejoin

Kicked members can apply to join the guild again. If permanent blocking is needed, a separate blocklist should be managed.