Account Authentication

This API allows login with email and password.

URL Confirmation

This API uses the service-account.playnanoo.com domain.

API Information

• URL: https://service-account.playnanoo.com/api/v20240101/email/signin
• Method: PUT
• Authentication Required: No

Request Parameters

Parameter	Type	Required	Description
linked_id	string	Required	Email address
linked_password	string	Required	Password
platform	string	Required	Platform (e.g., "aos", "ios")
device_id	string	Required	Device unique ID
device_model	string	Required	Device model name
device_os	string	Required	Device OS
device_language	string	Required	Device language (e.g., "KO", "EN")

DeviceInfo Inheritance

The Req class for this API inherits from DeviceInfo. All properties of DeviceInfo are automatically included.

Response Data

Res Class

Field	Type	Description
Token	SerializeTokenData	Token information
Player	SerializePlayerData	Player information

SerializeTokenData Structure

Field	Type	Description
AccessToken	string	Access token
RefreshToken	string	Refresh token

SerializePlayerData Structure

Field	Type	Description
UserUniqueID	string	User unique ID
OpenID	string	Open ID
Nickname	string	Nickname
LinkedID	string	Linked ID
LinkedType	string	Linked type
PurchaseCount	int	Purchase count
PurchaseCurrencyCode	string	Purchase currency code
PurchaseTotalPrice	double	Total purchase amount
PurchaseVoidedCount	int	Refund count
PurchaseVoidedCurrencyCode	string	Refund currency code
PurchaseVoidedTotalPrice	double	Total refund amount
Country	string	Country
Timezone	string	Timezone
Offset	int	Time offset
JoinPeriod	int	Join period

Unity C# Implementation

BaseResponse Class

Base class for all API responses.

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

Field descriptions:

• ErrorCode: Error code
• Message: Error message
• WithdrawalKey: Key required for recovery when the account is in withdrawal grace period (only provided for accounts pending withdrawal)
• BlockKey: Key provided when the account is blocked (only provided for blocked accounts)

Email Login Class

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;
    }
}

Usage Example

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("이메일 또는 비밀번호가 올바르지 않습니다.");
            }
        }
    ));
}

Password Security

Passwords are always transmitted securely through HTTPS and stored encrypted on the server. Do not store passwords in plain text on the client side either.