GetUserInfoByNickName

public BackendReturnObject GetUserInfoByNickName(string nickName);

Parameters

Value	Type	Description
nickName	string	Nickname of the user whose information is to be looked up

Description

Retrieves the user information of the user with the corresponding nickname.

The following information can be looked up:

• User's nickname
• User's gamerIndate
• Last accessed time
• Name of the guild the user belongs to

Example

Synchronous

var bro = Backend.Social.GetUserInfoByNickName("nickName");

//example
string gamerIndate = bro.GetReturnValuetoJSON()["row"]["inDate"].ToString();
if(bro.GetReturnValuetoJSON()["row"]["guildName"] != null) // null is returned when no guild name is registered
{
      string guildName = bro.GetReturnValuetoJSON()["row"]["guildName"].ToString();
}

Asynchronous

Backend.Social.GetUserInfoByNickName("ImATestUser", (callback) => 
{
    // Post-process

    //example
    string gamerIndate = callback.GetReturnValuetoJSON()["row"]["inDate"].ToString();
    if(callback.GetReturnValuetoJSON()["row"]["guildName"] != null) // null is returned when no guild name is registered
    {
        string guildName = callback.GetReturnValuetoJSON()["row"]["guildName"].ToString();
    }
});

SendQueue

SendQueue.Enqueue(Backend.Social.GetUserInfoByNickName, "ImATestUser", (callback) => 
{
    // Post-process

    //example
    string gamerIndate = callback.GetReturnValuetoJSON()["row"]["inDate"].ToString();
    if(callback.GetReturnValuetoJSON()["row"]["guildName"] != null) // null is returned when no guild name is registered
    {
        string guildName = callback.GetReturnValuetoJSON()["row"]["guildName"].ToString();
    }
});

ReturnCase

Success cases

When a user with the corresponding nickname exists

statusCode : 200

message : Success

returnValue : refer to GetReturnValuetoJSON

When a user with the corresponding nickname does not exist

statusCode : 404

errorCode : NotFoundException

message : gamer does not exist.

GetReturnValuetoJSON

{
    "row":
    {
        "nickname": "ImATestUser", // User's nickname
        "inDate":"2021-00-00T00:00:00.000Z", // User inDate
        "lastLogin":"2021-06-23T02:08:56.235Z", // Last time of login
        "guildName":"testGuild" // Name of the user's guild(null if non-existent)
    }
}

Sample Code

 public class SearchUserItem
 {
     public string nickname;
     public string inDate;
     public string lastLogin;
     public string guildName;

     public override string ToString()
     {
         return $"nickname : {nickname}\ninDate : {inDate}\nlastLogin : {lastLogin}\nguildName : {guildName}\n";
     }
 };

public void GetUserInfoByNickNameTest()
{
    string userNickname = "Nickname";

    var bro = Backend.Social.GetUserInfoByNickName(userNickname);

    if(!bro.IsSuccess())
        return;

    LitJson.JsonData json = bro.GetReturnValuetoJSON();

    SearchUserItem userInfo = new SearchUserItem();

    userInfo.nickname = json["row"]["nickname"].ToString();
    userInfo.inDate = json["row"]["inDate"].ToString();
    userInfo.lastLogin = json["row"]["lastLogin"].ToString();
    if(json["row"]["guildName"] != null)
    {
        userInfo.guildName = json["row"]["guildName"].ToString();
    }

    Debug.Log(userInfo.ToString());
}