查询已加入的公会

查询用户已加入的公会信息的 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}");
        }
    ));
}