인증 v4 IdP ID로 PlayerID 조회하기

웹 로그인 검증 V2 응답값인 idp_user_id를 검증하고, 이 IdP ID에 해당하는 PlayerID를 반환합니다. 웹 로그인 V2로 로그인 후 PlayerID를 획득할 수 있습니다.

Request URL

상용 URL	https://auth.qpyou.cn/game/player/get-playerid
분산환경 URL	https://sandbox-auth.globalwithhive.com/game/player/get-playerid
Sandbox URL	https://sandbox-auth.qpyou.cn/game/player/get-playerid
HTTP Method	Post
Content-Type	application/json
Data Format	JSON

Note

인증 v4는 장애가 발생하거나 네트워크 통신이 원활하지 않을 경우에 대비하여 분산 환경을 구성하고 있습니다. 만약 장애나 네트워크 통신 이상으로 게임서버에 정의된 통신 타임아웃 시간을 초과하면 분산환경 URL를 호출해야 합니다.

Request Header

필드명	설명	타입	필수여부
ISCRYPT	데이터 암호화 여부, 0=암호화 안함	Integer	Y

Request Body

필드명	설명	타입	필수여부
appid	로그인한 게임의 AppID	String	Y
idp_user_id	IdP에서 전달받은 Account Token(uid)	String	Y
idp_index	idp_index 1: HIVE 2: Facebook 3: GOOGLE 9: APPLE	Integer	Y
hive_certification_key	Hive 인증키 (Hive 콘솔 > 앱센터 > 프로젝트 관리 > 게임 상세 > 기본 정보 > Hive 인증키)	String	Y

Request Body Example

{
    "idp_user_id": "68101398",
    "appid" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
    "idp_index" : 1,
    "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
}

Response Body

필드명	설명	타입
result_code	검증 결과, `0`: 성공, `4000`: 파라미터값이 정상적이지 않음, `2002`: 연결된 PlayerID 없음	Integer
result_msg	결과 메시지	String
data	결과 데이터	JSON

Response Body - data

필드명	설명	타입
data.player_id	PlayerID	String
data.enc_idp	Request Body 정보 암호화 키	String
data.is_blocked	이용 정지 대상 여부	Boolean
data.is_refund	환불 유저 재결재 대상 여부	Boolean
data.list	결과 데이터 리스트	Array
data.list.player_id	Request Body `idp_user_id`에 해당하는 PlayerID	String
data.list.idp_user_id	Request Body로 요청한 `idp_user_id`	String
data.list.idp_index	Request Body로 요청한 `idp_index`	Integer

Response Body Sample: 정상

{
    "result_code": 0,
    "result_msg": "SUCCESS",
    "data": {
        "enc_idp": "K+A4xduO7kf5OrJ/iDPqL0PtMxwu7wW8JSBO+JJwSDDmJLvIi/6LG7TyWXdEHr9RNHM+/QXwc0+Y9z2eSRg7oeBBHmpOajzF1iiaacbFom4CsNy2fItendset7T0i0WYdyLQih3z5mDjcct47+gg2ovbp6kWRY8D+aGq+ZgaKiyr0Hmb1xmbWY/7cl1FjXTm0Nl9CWhO418bJFdwOpi+bw==",
        "player_id": "20000016588",
        "list": [
            {
                "player_id": "20000016588" ,
                "idp_user_id": "68101398",
                "idp_index": 1
            },
            {
                "player_id": "20000016588",
                "idp_user_id": "0",
                "idp_index": 0
            }
        ],
        "is_blocked" : false,
        "is_refund" : false
    }
}

Response Body Sample: 2002 코드

{
    "result_code": 2002,
    "result_msg": "No User",
    "data":{
        "enc_idp": "K+A4xduO7kf5OrJ/iDPqLyCHfP+L3wz0WTNVw5KHLCqYjqQ+shQ2P3mkgwYCMvlnPatzlSE5ZFINr5gEIxK14sg0N8kOPSjSCeQ9UGGt11OMrYsGTuys0KmPJ2ZU/UWVVxpP1Lxx1eS8VbYwLmoTG+HTw2vkocghs/ZOZ9rqisdBRprhp6Q6+lIjpaUzDa2yy2guM1WheuVzKGL5331HHgo557RqoyUzTc6Lkf8ArWZ/XSwi3ZmStmhz/U4thcIwiowqgV+Ecdb2+WmMZ1MgGT4Xvbxa4lqzToBC3nxDvi1d8TjgMaszVYoNct94WPBGvV6emg3GqiJG+0ZTGg53+mZad9ttkUpTnQXetz5UDTxe5NnFAYfffzBq3jkqfAB042eH21rE3uTVJq3HuO8i9t1LJwKFfkC7sjjuaKNWsjs="
    }
}