버전 비교

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

Integration Guide > /wiki/spaces/KS4GFP/pages/533921827

목차
minLevel1
maxLevel1
outlinefalse
typelist
printablefalse

...

/member/player

Description

Player Query

Method

...

Status Code

Status Code Description

Status Code Detailed Description

200

Normal Response

Normal

400

Bad Request

Unparsable request data, missing mandatory parameters, or parameter type error

401

Unauthenticated

Authentication Failed

406

Not Acceptable

Cannot process

500

Internal Server Error

Internal Server Errorserver system error

503

Service Unavailable

Service unavailable (e.g., internal server timeout)

...

코드 블럭
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 authentication error.
HTTP/1.1 401

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

// No player information (-10005)
HTTP/1.1 406 Not Acceptable
{
    "desc": "There is no player. (406.-10005)"
}

...

/member/player-list

Description

Retrieve a list of players.

...

Status Code

Status Code Description

Status Code Detailed Description

200

Normal Response

Normal

400

Bad Request

Unparsable request data, missing mandatory parameters, or parameter type error

401

Unauthenticated

Authentication Failed

406

Not Acceptable

Cannot process

500

Internal Server Error

Internal Server Errorserver system error

503

Service Unavailable

Service unavailable (e.g., internal server timeout)

...

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

// playerIds query > response 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 query > response 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"
                }                  
            }              
        }
    ]
}

// No player information
HTTP/1.1 406 Not Acceptable

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

...

/member/player/member-key

Description

Query player member keys

...

Status Code

Status Code Description

Status Code Detailed Description

200

Normal Response

Normal

400

Bad Request

Unparsable request data, missing mandatory parameters, or parameter type error

401

Unauthenticated

Authentication Failed

406

Not Acceptable

Cannot process

500

Internal Server Error

Internal Server Errorserver system error

503

Service Unavailable

Service unavailable (e.g., internal server timeout)

...

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

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


// No player information
HTTP/1.1 406 Not Acceptable
{
  "desc": "There is no player. (406.-10005)"
}

...

/member/uuid/player-id

Description

Retrieve playerId using kgAppId and UUID.

...

Status Code

Status Code Description

Status Code Detailed Description

200

Normal Response

Normal

400

Bad Request

Unparsable request data, missing mandatory parameters, or parameter type error

401

Unauthenticated

Authentication Failed

406

Not Acceptable

Cannot process

500

Internal Server Error

Internal Server Errorserver system error

503

Service Unavailable

Service unavailable (e.g., internal server timeout)

...

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

...

/member/idp/info-list

Description

Retrieve a list of IDP information of a player.

...

Status Code

Status Code Description

Status Code Detailed Description

200

Normal Response

Normal

400

Bad Request

Unparsable request data, missing mandatory parameters, or parameter type error

401

Unauthenticated

Authentication Failed

406

Not Acceptable

Cannot process

500

Internal Server Error

Internal Server Errorserver system error

503

Service Unavailable

Service unavailable (e.g., internal server timeout)

...