Member Conversion

This API links a guest account to a social account.

URL Confirmation

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

API Information

• URL: https://service-account.playnanoo.com/api/v20240401/social/change
• Method: PUT
• Authentication Required: Yes

Request Parameters

Parameter	Type	Required	Description
account_token	string	Required	Social account token
account_type	string	Required	Social account type (e.g., "google", "facebook", "apple")
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)

Social Account Link Class

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

Usage Example

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}]");
        }
    ));
}

Social Account Types

Supported account_type values:

• "google": Google account
• "facebook": Facebook account
• "apple": Apple account