버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

연동 가이드 > /wiki/spaces/KS4GFP/pages/533921827 프로필(플레이어 정보)

목차
minLevel1
maxLevel1
outlinefalse
typelist
printablefalse

...

/member/player

Description

플레이어 조회

Method

GET

...

코드 블럭
languagejson
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8  

{
    "kgAppId": "909428",
    "playerId": "255331998494720",
    "status": "normal",
    "info": {
        "nickname": "kakaogames-1684393113872",
        "lang" : "KO"
        "lastLoginTime": 1684393114000
   }
}  

// accessToken 인증 에러.
HTTP/1.1 401

{
    "desc": "Invalid player token. (401.-20007)"
}  

// 플레이어 정보 없음 (-10005)
HTTP/1.1 406 Not Acceptable
{
    "desc": "There is no player. (406.-10005)"
}

...

/member/player-list

Description

플레이어 리스트 조회

Method

...

코드 블럭
languagejson
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8  

// playerIds 조회 > 응답 결과 playerId key
{
    "players": [
        {
            "156176766994432": {
                "kgAppId": "909428",
                "playerId": "156176766994432",
                "status": "normal",
                "nickname": "kakaogames-1672048155324",
                "lang": "ko",
                "data": {
                  "country": "kr",
                  "deviceId": "1234567890qwerasdfzxcv"
                }                  
            }
        },
        {
            "156176766994123": {
                "kgAppId": "909428",
                "playerId": "156176766994123",
                "status": "normal",
                "nickname": "kakaogames-1672048155324",
                "lang": "ko",
                "data": {
                  "country": "kr",
                  "deviceId": "1234567890qwerasdfzxcv"
                }                  
            }              
        }
    ]
}


// idpIds 조회 > 응답 결과 idpId key
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8  

{
    "players": [
        {
            "1234567": {
                "kgAppId": "909428",
                "playerId": "156176766994432",
                "status": "normal",
                "nickname": "kakaogames-1672048155324",
                "lang": "ko",
                "data": {
                  "country": "kr",
                  "deviceId": "1234567890qwerasdfzxcv"
                }                  
            }
        },
        {
            "2222222": {
                "kgAppId": "909428",
                "playerId": "156176766994123",
                "status": "normal",
                "nickname": "kakaogames-1672048155324",
                "lang": "ko",
                "data": {
                  "country": "kr",
                  "deviceId": "1234567890qwerasdfzxcv"
                }                  
            }              
        }
    ]
}

// 플레이어 정보 없음
HTTP/1.1 406 Not Acceptable

{
    "desc": "There is no player. (406.-10005)"
}

...

/member/player/member-key

Description

플레이어의 멤버키 조회

Method

...

코드 블럭
languagejson
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8  

{
  "memberKeyMap": {
    "kakaocapri": "KSa5X29vLQONBFWdPGu6ji_FQThn3.U3gdoLVUBHpFzMZtsEEhGHmcBocceNJc_H"
  }
}


// 플레이어 정보 없음
HTTP/1.1 406 Not Acceptable
{
  "desc": "There is no player. (406.-10005)"
}

...

/member/uuid/player-id

Description

kgAppId와 UUID를 입력받아서 해당하는 playerId를 리턴합니다.

...

코드 블럭
languagejson
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8  
{
    "playerId": "314621196361"
}

...

/member/idp/info-list

Description

플레이어의 idp정보 목록 조회

...