会员转换

将游客账户关联到社交账户的 API。

URL 确认

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

API 信息

• URL: https://service-account.playnanoo.com/api/v20240401/social/change
• Method: PUT
• 需要认证: 是

请求参数

参数	类型	必需	说明
account_token	string	必需	社交账户令牌
account_type	string	必需	社交账户类型（例如："google"、"facebook"、"apple"）
platform	string	必需	平台（例如："aos"、"ios"）
device_id	string	必需	设备唯一 ID
device_model	string	必需	设备型号
device_os	string	必需	设备 OS
device_language	string	必需	设备语言（例如："KO"、"EN"）

DeviceInfo 继承

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

响应数据

Res 类

字段	类型	说明
Token	SerializeTokenData	令牌信息
Player	SerializePlayerData	玩家信息

SerializeTokenData 结构

字段	类型	说明
AccessToken	string	访问令牌
RefreshToken	string	刷新令牌

SerializePlayerData 结构

字段	类型	说明
UserUniqueID	string	用户唯一 ID
OpenID	string	开放 ID
Nickname	string	昵称
LinkedID	string	关联 ID
LinkedType	string	关联类型
PurchaseCount	int	购买次数
PurchaseCurrencyCode	string	购买货币代码
PurchaseTotalPrice	double	购买总金额
PurchaseVoidedCount	int	退款次数
PurchaseVoidedCurrencyCode	string	退款货币代码
PurchaseVoidedTotalPrice	double	退款总金额
Country	string	国家
Timezone	string	时区
Offset	int	时间偏移量
JoinPeriod	int	注册时长

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 UnityEngine.Networking;

public class SocialChange
{
    static string path = "https://service-account.playnanoo.com/api/v20240401/social/change";

    [Serializable]
    public class Req : DeviceInfo
    {
        public string account_token;
        public string account_type;

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

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

    [Serializable]
    public class Res : BaseResponse
    {
        public SerializeTokenData Token;
        public SerializePlayerData Player;
    }

    [Serializable]
    public class SerializeTokenData
    {
        public string AccessToken;
        public string RefreshToken;
    }

    [Serializable]
    public class SerializePlayerData
    {
        public string UserUniqueID;
        public string OpenID;
        public string Nickname;
        public string LinkedID;
        public string LinkedType;
        public int PurchaseCount;
        public string PurchaseCurrencyCode;
        public double PurchaseTotalPrice;
        public int PurchaseVoidedCount;
        public string PurchaseVoidedCurrencyCode;
        public double PurchaseVoidedTotalPrice;
        public string Country;
        public string Timezone;
        public int Offset;
        public int JoinPeriod;
    }
}

使用示例

public void ChangeSocialAccount(string googleToken)
{
    SocialChange.Req req = new SocialChange.Req();

    StartCoroutine(req.Send(
        account_token: googleToken,
        account_type: "google",
        onSuccess: res =>
        {
            // 令牌
            Debug.Log($"AccessToken: {res.Token.AccessToken}");
            Debug.Log($"RefreshToken: {res.Token.RefreshToken}");

            // 玩家信息
            Debug.Log($"UserUniqueID: {res.Player.UserUniqueID}");
            Debug.Log($"OpenID: {res.Player.OpenID}");
            Debug.Log($"Nickname: {res.Player.Nickname}");
            Debug.Log($"LinkedID: {res.Player.LinkedID}");
            Debug.Log($"LinkedType: {res.Player.LinkedType}");
            Debug.Log($"Country: {res.Player.Country}");
        },
        onError: (error) =>
        {
            Debug.LogError($"소셜 계정 연동 실패: [{error.ErrorCode}] [{error.Message}]");
        }
    ));
}

社交账户类型

支持的 account_type 值：

• "google"：Google 账户
• "facebook"：Facebook 账户
• "apple"：Apple 账户