查询公会成员

查询公会成员列表的 API。

URL 确认

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

API 信息

• URL: https://service-api.playnanoo.com/guild/v20230101/member/search
• 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 GuildMemberSearch
{
    static string path = "https://service-api.playnanoo.com/guild/v20230101/member/search";

    [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 SearchMembers()
{
    GuildMemberSearch.Req req = new GuildMemberSearch.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}, Grade: {item.Grade}");
            }
        },
        onError: (error) =>
        {
            Debug.LogError($"멤버 조회 실패: [{error.ErrorCode}] {error.Message}");
        }
    ));
}