멤버 등급 변경

길드 멤버의 등급을 변경합니다.

URL 확인

이 API는 service-api.playnanoo.com 도메인을 사용합니다.

API 정보

• URL: https://service-api.playnanoo.com/guild/v20230101/member/changeGrade
• Method: PUT
• 인증 필요: 예 (Bearer Token)

요청 파라미터

파라미터	타입	필수	설명
device_id	string	필수	디바이스 ID
table_code	string	필수	테이블 코드
uid	string	필수	길드 고유 ID
member_uuid	string	필수	등급을 변경할 멤버의 UUID
grade	string	필수	변경할 등급

응답 데이터

응답 정보

• Status: 처리 결과

코드 예제

void UMyGame::ChangeMemberGrade(const FString& DeviceId, const FString& TableCode, const FString& GuildUid, const FString& MemberUuid, const FString& Grade)
{
    // 플레이어 정보가 포함된 요청 바디 생성
    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);
    Body->SetStringField(TEXT("grade"), Grade);

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

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

    Request->ProcessRequest();
}

인증 필요

이 API는 Bearer 토큰 인증이 필요합니다. 먼저 로그인하여 액세스 토큰을 발급받아야 합니다.

권한 필요

멤버의 등급을 변경하려면 길드 마스터 또는 관리자 권한이 필요합니다.

등급 타입

grade 파라미터는 길드 시스템에서 정의한 등급 값을 사용합니다:

• "master": 길드 마스터 (최고 권한)
• "officer": 임원/부마스터 (관리 권한)
• "member": 일반 멤버 (기본 권한)

등급 체계는 게임에 따라 다를 수 있으므로 테이블 설정을 확인하세요.