GetUserInfoByInDateV2

public BackendReturnObject GetUserInfoByInDateV2(string gamerInDate);

Parameters

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

Description

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

V2 adds country code and group name to the return value of the existing API.

User's metadata

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

Example

Synchronous

var bro = Backend.Social.GetUserInfoByInDate("2021-00-00T00:00:00.000Z");

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

Asynchronous

Backend.Social.GetUserInfoByInDate("2021-00-00T00:00:00.000Z", (callback) => 
{
    // Post-process

    //example
    string nickname = callback.GetReturnValuetoJSON()["row"]["nickname"].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.GetUserInfoByInDate, "2021-00-00T00:00:00.000Z", (callback) => 
{
    // Post-process

    //example
    string nickname = callback.GetReturnValuetoJSON()["row"]["nickname"].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 inDate exists

statusCode : 200

message : Success

returnValue : refer to GetReturnValuetoJSON

When a user with the corresponding inDate does not exist

statusCode : 404

errorCode : NotFoundException

message : gamer does not exist.

GetReturnValuetoJSON

{
    "row":
    {
        "nickname":"ImATestUser", // User's nickname (null if not present)
        "inDate":"2021-00-00T00:00:00.000Z", // User's inDate
        "lastLogin":"2021-06-23T02:08:56.235Z", // User's last login time
        "guildName":"testGuild" // User's guid name (null if not present)
        "countryCode": "KR",    // null if the country code is not set
        "propertyGroup": "USA"  // null if there is no group,
    }
}

Sample Code

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

      public override string ToString()
      {
        return $"nickname: {nickname}\n" +
        $"inDate: {inDate}\n" +
        $"lastLogin: {lastLogin}\n" +
        $"guildName: {guildName}\n" +
        $"countryCode: {countryCode}\n" +
        $"propertyGroup: {propertyGroup}\n";        
      }
  };

public void GetUserInfoByInDateTest()
{
    string userNickname = "2021-11-24T02:44:14.638Z";

    var bro = Backend.Social.GetUserInfoByInDate(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();
    userInfo.guildName = json["row"]["guildName"]?.ToString();    
    userInfo.countryCode = json["row"]["countryCode"]?.ToString();
    userInfo.propertyGroup = json["row"]["propertyGroup"]?.ToString();
    
    Debug.Log(userInfo.ToString());
}