인증 API로 유저 정보 조회

인증 API로 유저 정보 조회 는 웹 로그인 완료 후, 별도로 유저 정보를 확인해야 하는 경우 요청하는 API입니다.

로그인 검증 및 유저 정보 조회 API의 응답 값인 appid, idp_index, idp_user_id를 사용하여 IdP에 해당하는 유저 정보를 반환합니다.

Request URL¶

환경	URL
상용 (Production)	https://auth.qpyou.cn/game/player/get-playerid
분산 (Production)	https://auth.globalwithhive.com/game/player/get-playerid
샌드박스 (Sandbox)	https://sandbox-auth.qpyou.cn/game/player/get-playerid
HTTP Method	POST
Content-Type	application/json

Note

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

Request Header¶

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

Request Body¶

필드명	타입	설명	필수여부
appid	String	앱 아이디	Y
idp_index	Integer	IdP 인덱스 `1`: Hive `2`: Facebook `3`: Google `9`: Apple	Y
idp_user_id	String	IdP 고유 식별자	Y
hive_certification_key	String	Hive 인증키 (Hive 콘솔 > 앱센터 > 프로젝트 관리 > 게임 상세 > 기본 정보 > Hive 인증키)	Y

Request Body Example¶

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

Response Body¶

필드명	타입	설명	비고
result_code	Integer	결과 코드
result_msg	String	결과 메시지
data	JSON	결과 데이터
data.enc_idp	String	Request Body 정보를 암호화한 키	웹 > PC 외부 자동 로그인용 1회용 토큰
data.player_id	BigInteger	PlayerID
data.list	Array	연동된 IdP 리스트	유저가 연동한 IdP 정보를 담은 리스트
data.list.seq	BigInteger	연동된 IdP 리스트 - Seq	인증에서만 사용 하는 Sequence Key
data.list.player_id	BigInteger	연동된 IdP 리스트 - PlayerID
data.list.idp_user_id	String	연동된 IdP 리스트 - IdP 고유 식별자
data.list.idp_index	Integer	연동된 IdP 리스트 - IdP 인덱스	`1`: Hive `2`: Facebook `3`: Google `9`: Apple
data.list.idp_id	String	연동된 IdP 리스트 - IdP 아이디	GUEST는 다른 IdP로 플레이 했어도 기본으로 생성
data.is_blocked	Boolean	이용 정지 여부	`true`: 이용 정지 유저 `false`: 정상 유저
data.is_refund	Boolean	환불 유저 재결재 대상 여부	`true`: 환불 유저 재결제 대상 유저 `false`: 환불 유저 재결제 미대상 유저

결과 코드¶

result_code	설명
0	성공
2002	유저 데이터 없음
4000	유효하지 않은 요청 파라미터

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": [
      {
        "seq": 25771,
        "player_id": 20000016588,
        "idp_user_id": "68101398",
        "idp_index": 1,
        "idp_id": "HIVE"
      },
      {
        "seq": 25772,
        "player_id": 20000016588,
        "idp_user_id": "0",
        "idp_index": 0,
        "idp_id": "GUEST"
      }
    ],
    "is_blocked": false,
    "is_refund": false
  }
}

Response Body Sample (유저 정보 없음)¶

{
  "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="
  }
}

Response Body Sample (실패)¶

{
  "result_code": 4000,
  "result_msg": "Request has invalid format.",
  "data": "appid, idp_user_id, idp_index"
}