申请加入 公会 查询

用户 加入 申请 公会 列表 查询。

URL确认

此API使用 service-api.playnanoo.com 域名。

API信息

• URL: https://service-api.playnanoo.com/guild/v20230101/personal/request/search
• Method: PUT
• 需要认证: 是 (Bearer Token)

请求参数

参数	类型	必填	说明
device_id	string	必填	设备 ID
table_code	string	必填	表 代码

响应数据

RequestInfo 数组

每个加入申请信息包含以下字段:

• Uid: 公会 唯一 ID
• Name: 公会 名称
• MemberCount: 当前 成员数
• MemberLimit: 成员限制数
• AutoJoin: 自动 加入 与否
• ExtraData: 公会 添加 数据
• RequestedAt: 加入申请日期

代码示例

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

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

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-api.playnanoo.com/guild/v20230101/personal/request/search"));
    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))
            {
                int32 Total = JsonObject->GetIntegerField(TEXT("Total"));
                const TArray<TSharedPtr<FJsonValue>>* RequestsArray;

                if (JsonObject->TryGetArrayField(TEXT("Requests"), RequestsArray))
                {
                    UE_LOG(LogTemp, Log, TEXT("가입 신청 목록 조회 성공! 총 %d개"), Total);

                    for (const auto& RequestValue : *RequestsArray)
                    {
                        TSharedPtr<FJsonObject> Request = RequestValue->AsObject();
                        FString Name = Request->GetStringField(TEXT("Name"));
                        FString Uid = Request->GetStringField(TEXT("Uid"));

                        UE_LOG(LogTemp, Log, TEXT("Guild: %s"), *Name);
                    }
                }
            }
        }
    });

    Request->ProcessRequest();
}

需要认证

此API需要Bearer Token认证。需要先登录获取访问Token。

使用方法

使用此API可以：

• 确认用户向哪些公会提交了加入申请
• 显示等待中的加入申请数量
• 在需要取消申请时提供公会列表

响应数据

• Requests: 已申请加入的公会列表 (TArray)
• Total: 总加入申请数
• 没有加入申请时返回空数组。

不可重复申请

对同一公会只能提交一个加入申请。已申请的公会无法重复申请。