가입 길드 조회

사용자가 가입한 길드 정보를 조회하는 API입니다.

URL 확인

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

API 정보

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

요청 파라미터

파라미터	타입	필수	설명
table_code	string	필수	테이블 코드

DeviceInfo 상속

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

응답 데이터

Res 클래스

필드	타입	설명
GuildUid	string	길드 고유 ID
GuildName	string	길드 이름
GuildPoint	double	길드 포인트
GuildMemberCount	int	현재 멤버 수
GuildMemberLimit	int	멤버 제한 수
GuildAutoJoin	string	자동 가입 여부
GuildExtraData	string	길드 추가 데이터
MemberGrade	int	멤버 등급
MemberPoint	int	멤버 포인트
MemberInDate	string	가입 일시

Unity C# 구현

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

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

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

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

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

    [Serializable]
    public class Res : BaseResponse
    {
        public string GuildUid;

        public string GuildName;

        public double GuildPoint;

        public int GuildMemberCount;

        public int GuildMemberLimit;

        public string GuildAutoJoin;

        public string GuildExtraData;

        public int MemberGrade;

        public int MemberPoint;

        public string MemberInDate;
    }
}

사용 예제

public void GetPersonalGuild()
{
    GuildPersonal.Req req = new GuildPersonal.Req();

    StartCoroutine(req.Send(
        tableCode: "guild_table",
        onSuccess: res =>
        {
            Debug.Log($"GuildUid: {res.GuildUid}, GuildName: {res.GuildName}");
            Debug.Log($"GuildPoint: {res.GuildPoint}, MemberCount: {res.GuildMemberCount}/{res.GuildMemberLimit}");
            Debug.Log($"MemberGrade: {res.MemberGrade}, MemberPoint: {res.MemberPoint}");
        },
        onError: (error) =>
        {
            Debug.LogError($"가입 길드 조회 실패: [{error.ErrorCode}] {error.Message}");
        }
    ));
}