인증 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 BigInteger
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 BigInteger
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="
    }
}