账户认证

使用邮箱和密码登录的 API。

URL 确认

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

API 信息

• URL: https://service-account.playnanoo.com/api/v20240101/email/signin
• Method: PUT
• 需要认证: 否

请求参数

参数	类型	必需	说明
linked_id	string	必需	邮箱地址
linked_password	string	必需	密码
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 EmailSignin
{
    static string path = "https://service-account.playnanoo.com/api/v20240101/email/signin";

    [Serializable]
    public class Req : DeviceInfo
    {
        public string linked_id;
        public string linked_password;

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

            yield return HttpClient.Send<Req, Res>(
                UnityWebRequest.kHttpVerbPUT,
                path,
                requireToken: false,
                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 EmailLogin(string email, string password)
{
    EmailSignin.Req req = new EmailSignin.Req();

    StartCoroutine(req.Send(
        linked_id: email,
        linked_password: password,
        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}]");

            if (error.ErrorCode == "INVALID_CREDENTIALS")
            {
                Debug.LogError("이메일 또는 비밀번호가 올바르지 않습니다.");
            }
        }
    ));
}

密码安全

密码始终通过 HTTPS 安全传输，并以加密形式存储在服务器中。请不要在客户端以明文形式存储密码。