Token Lookup

This API retrieves information about an access token.

URL Confirmation

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

API Information

• URL: https://service-account.playnanoo.com/api/v20240401/token/info
• Method: GET
• Authentication Required: Yes (Bearer Token)

Request Parameters

Parameter	Type	Required	Description
access_token	string	Required	Access token to look up
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 in withdrawal grace period)
• BlockKey: Key provided when the account is blocked (only provided for blocked accounts)

Token Information Lookup Class

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

public class TokenInfo
{
    static string path = "https://service-account.playnanoo.com/api/v20240401/token/info";

    [Serializable]
    public class Req : DeviceInfo
    {
        public string access_token;

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

            yield return HttpClient.Send<Req, Res>(
                UnityWebRequest.kHttpVerbGET,
                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;
    }
}

Usage Example

public void GetTokenInfo(string accessToken)
{
    TokenInfo.Req req = new TokenInfo.Req();

    StartCoroutine(req.Send(
        access_token: accessToken,
        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}");
        },
        onError: (error) =>
        {
            Debug.LogError($"토큰 정보 조회 실패: [{error.ErrorCode}] [{error.Message}]");
        }
    ));
}

Bearer Token Authentication

This API uses Bearer Token authentication. Setting requireToken: true automatically includes the authentication token in the HTTP header.