길드 가입 신청 목록 조회

길드 가입 요청 목록을 조회하는 API입니다.

URL 확인

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

API 정보

• URL: https://service-api.playnanoo.com/guild/v20230101/member/request
• Method: PUT
• 인증 필요: 예

요청 파라미터

파라미터	타입	필수	설명
table_code	string	필수	테이블 코드
uid	string	필수	길드 고유 ID

DeviceInfo 상속

이 API의 Req 클래스는 DeviceInfo를 상속받습니다. DeviceInfo의 모든 속성이 자동으로 포함됩니다.

응답 데이터

Res 클래스

필드	타입	설명
Items	List\<MemberItemModel>	가입 신청 멤버 목록

MemberItemModel 구조

필드	타입	설명
Uuid	string	멤버 UUID
Nickname	string	닉네임
Grade	int	등급
Point	double	포인트
ExtraData	string	추가 데이터
LastLoginDate	string	마지막 로그인 일시
InDate	string	신청 일시

Unity C# 구현

using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Networking;

public class GuildMemberRequest
{
    static string path = "https://service-api.playnanoo.com/guild/v20230101/member/request";

    [Serializable]
    public class Req : DeviceInfo
    {
        public string table_code;
        public string uid;

        public IEnumerator Send(
            string tableCode,
            string uid,
            Action<Res> onSuccess,
            Action<BaseResponse> onError
        )
        {
            if (!string.IsNullOrEmpty(tableCode)) this.table_code = tableCode;
            if (!string.IsNullOrEmpty(uid)) this.uid = uid;

            yield return HttpClient.Send<Req, Res>(
                UnityWebRequest.kHttpVerbPUT,
                path,
                requireToken: true,
                body: this,
                onSuccess: onSuccess,
                onError: onError
            );
        }
    }

    [Serializable]
    public class Res : BaseResponse
    {
        public List<MemberItemModel> Items;
    }

    [Serializable]
    public class MemberItemModel
    {
        public string Uuid;

        public string Nickname;

        public int Grade;

        public double Point;

        public string ExtraData;

        public string LastLoginDate;

        public string InDate;
    }
}

사용 예제

public void GetMemberRequests()
{
    GuildMemberRequest.Req req = new GuildMemberRequest.Req();

    StartCoroutine(req.Send(
        tableCode: "guild_table",
        uid: "guild_uid",
        onSuccess: res =>
        {
            foreach (var item in res.Items)
            {
                Debug.Log($"Uuid: {item.Uuid}, Nickname: {item.Nickname}");
            }
        },
        onError: (error) =>
        {
            Debug.LogError($"가입 신청 조회 실패: [{error.ErrorCode}] {error.Message}");
        }
    ));
}