IDP 목록 조회¶

앱 클라이언트에서 로그인 성공 후 반환된 Player ID와 App ID를 사용하여, 앱 서버에서 해당 플레이어와 연동된 IdP(Identity Provider) 목록을 조회합니다.

'IDP 목록 조회' API는 앱 서버에서 Hive 인증 서버로 직접 호출하는 Server-to-Server 통신 방식으로 동작하며, 요청 성공 시 응답의 data 필드에 연동된 IdP 정보가 배열 형태로 반환됩니다.

요청 시, App ID와 Player ID는 필수로 전송해야 하는 파라미터입니다.

Request URL¶

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

Note

Hive 인증 서버는 장애가 발생하거나 네트워크 통신이 원활하지 않을 경우에 대비하여 분산 환경 기반으로 구성됩니다.
인증 서버 호스트와의 통신 중 장애가 발생하거나 앱 서버에 정의된 타임아웃(Timeout) 시간을 초과하는 경우, 앱 서버에서 직접 분산 환경 URL(Fallback URL)을 호출해야 합니다.

Request header¶

필드명	설명	타입	필수여부
X-Access-Token	게임 서버 인증을 위한 OAuth 2.0 Access Token (OAuth Token 발급하기 참고)	String	Y
ISCRYPT	데이터 암호화 여부 (0= 암호화 안 함) (무조건 0으로 전달)	Integer	Y

Request body¶

필드명	설명	타입	필수여부
appid	App ID	String	Y
player_id	로그인 성공 후 반환된 인증 Player ID	BigInteger	Y

Request example¶

{
    "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "player_id": 90000000062
}

Response Body¶

필드명	설명	타입
result_code	응답 코드 자세히	Integer
result_msg	결과 메시지	String
token_validation	JWT 검증 결과 (JWT 검증 에러)	Object
token_validation.result_code	JWT 검증 결과 코드	Integer
token_validation.result_msg	JWT 검증 결과 메시지	String
data	IdP 목록 데이터	Array
data[].seq	사용자 기본 키 (PK)	BigInteger
data[].player_id	Player ID	BigInteger
data[].idp_user_id	IdP에서 주는 사용자 ID 값	String
data[].idp_index	IdP 고유 번호 자세히	Integer
data[].idp_id	IdP의 String 값	String

결과 코드¶

코드값	설명
0	성공
2002	사용자 데이터 없음
4000	유효하지 않은 파라미터
2499	JWT 검증 실패 (token_validation 참고)

Response example¶

성공¶

{
    "result_code": 0,
    "result_msg": "SUCCESS",
    "token_validation": {
        "result_code": 0,
        "result_msg": "success"
    },
    "data": [
        {
            "seq": 10000000067,
            "player_id": 90000000062,
            "idp_user_id": "0",
            "idp_index": 0,
            "idp_id": "GUEST"
        },
        {
            "seq": 10000000068,
            "player_id": 90000000062,
            "idp_user_id": "64646595",
            "idp_index": 1,
            "idp_id": "HIVE"
        }
    ]
}

JWT 검증 실패¶

{
    "result_code": 2499,
    "result_msg": "JWT validation failed. See token_validation for details.",
    "token_validation": {
        "result_code": 2408,
        "result_msg": "The access token is expired. Please refresh your token."
    }
}

Note

JWT 검증 실패 시, token_validation 필드로 상세 에러 정보를 확인할 수 있습니다. 자세한 내용은 JWT 검증 에러 코드를 참고하세요.

IdP 인덱스¶

IdP 인덱스 정보는 IdP 리스트를 참고하세요.