查询好友请求列表

查询待处理的好友请求列表。

URL 确认

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

API 信息

• URL: https://service-api.playnanoo.com/friend/v20231201/searchPending
• Method: PUT
• 需要认证: 是

DeviceInfo 继承

此 API 的 Req 类继承自 DeviceInfo。DeviceInfo 的所有属性将自动包含。

请求参数

参数	类型	必填	说明
table_code	string	必填	好友表代码

响应数据

Res 类

字段	类型	说明
Items	List<FriendItem>	待处理的好友请求列表

FriendItem 类

字段	类型	说明
RelationshipCode	string	关系代码
UserId	string	用户 ID
Nickname	string	昵称
Timezone	string	时区
AccessSeconds	double	最后访问时间 (秒)

Unity C# 实现

BaseResponse 类

所有 API 响应的基类。

public class BaseResponse
{
    public string ErrorCode;
    public string Message;
    public string WithdrawalKey;
    public string BlockKey;
}

字段说明:

• ErrorCode: 错误代码
• Message: 错误消息
• WithdrawalKey: 处于注销等待状态时用于恢复的密钥 (仅在注销等待中的账户提供)
• BlockKey: 账户被封禁时提供的密钥 (仅在被封禁的账户提供)

查询待处理好友请求类

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

public class FriendReadyAll
{
    static string path = "https://service-api.playnanoo.com/friend/v20231201/searchPending";

    [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 List<FriendItem> Items;
    }

    [Serializable]
    public class FriendItem
    {
        public string RelationshipCode;
        public string UserId;
        public string Nickname;
        public string Timezone;
        public double AccessSeconds;
    }
}

使用示例

using PlayNANOO;

public class PlayNANOOExample : MonoBehaviour
{
    void GetPendingFriendRequests()
    {
        FriendReadyAll.Req req = new FriendReadyAll.Req();

        StartCoroutine(req.Send(
            tableCode: "friend_table",
            onSuccess: res =>
            {
                Debug.Log($"대기 중인 친구 요청: {res.Items.Count}건");

                foreach (var request in res.Items)
                {
                    Debug.Log($"요청자: {request.Nickname}");
                    Debug.Log($"  관계 코드: {request.RelationshipCode}");
                }
            },
            onError: (error) =>
            {
                Debug.LogError($"대기 중인 친구 요청 조회 실패: [{error.ErrorCode}] [{error.Message}]");
            }
        ));
    }
}

接受/拒绝

待处理的好友请求可以通过 accept API 接受，或通过 delete API 拒绝。