로그인 페이지 호출하기 v1

사용자가 로그인할 수 있는 Hive 웹 로그인 URL 주소를 불러옵니다. 사용자가 로그인을 마치면 개발사가 설정한 리다이렉트 URL과 로그인 검증을 위한 playerId와 토큰을 반환합니다. IdP 계정은 Hive, Google, Facebook, Apple 계정을 지원합니다.

앱을 Hive SDK로 개발했을 때 웹 로그인 V1 API 사용을 권장하지 않습니다. 왜냐하면, PlayerID는 게임 플레이 기록을 포함하고 있으므로, 사용자가 과거에 웹 로그인 V1으로 로그인했던 계정과 현재 게임 접속 후에 로그인한 계정을 연동하려고 시도하면 계정 충돌이 발생할 수 있기 때문입니다.

Note

웹 로그인 v1을 사용하려면 먼저 아래와 같이 Hive 콘솔 앱 센터에서 관련 설정을 마쳐야합니다. 자세한 내용은 콘솔 가이드를 확인하세요.

Request URL

상용 URL	https://weblogin.withhive.com/login?param=
Sandbox URL	https://sandbox-weblogin.withhive.com/login?param=

Request Header

HTTP Method	GET
Content-Type	text/html

Query Parameters

필드명	타입	설명	필수 여부
param	string	param string 값은 아래 테이블에 있는 key값으로 구성한 JSON 데이터를 URL 인코딩 후 BASE64 인코딩을 거쳐 생성합니다.	Y

Query Parameters - param

필드명	타입	설명
appid	string	Hive에서 사용하는 Application ID
gindex	string	Hive 에서 사용하는 Game Index 정보입니다. Hive 콘솔 앱 센터 > 게임 목록 > 게임사 게임 검색 후 클릭 > App ID 탭 클릭 > 게임 App ID 클릭 > 기본 정보 탭에서 획득 가능합니다.
url	string	유저 로그인 완료 후 리다이렉트시킬 URL 주소입니다. Hive 콘솔에서 설정한 리다이렉트 URL과 일치해야 합니다.
country	string	게임 또는 커뮤니티에서 설정한 국가 코드입니다. 이 값을 전달하지 않으면 웹 브라우저 기본값을 사용합니다.
language	string	게임 또는 커뮤니티에서 설정한 언어 코드입니다. 이 값을 전달하지 않으면 웹 브라우저 기본값을 사용합니다.

Request Example

// JSON 객체로 구성한 param 원본. 이 JSON 객체에 URL 인코딩과 BASE64 인코딩을 차례대로 수행하여 얻은 string 값을 API 호출 시 쿼리 파라미터로 사용함.
{
    "appid":"com.com2us.hivesdk.ios.community.global.normal",
    "gindex":"539",
    "url":"https://community.withhive.com/hivesdk/login/redirect",
    "country":"KR",
    "language":"ko"
}

// Request URL에 쿼리 파라미터 형태로 인코딩을 마친 param을 붙여서 호출함
https://weblogin.withhive.com/login?param=JTdCJTIyYXBwaWQlMjIlM0ElMjJjb20uY29tMnVzLmhpdmVzZGsuaW9zLmNvbW11bml0eS5nbG9iYWwubm9ybWFsJTIyJTJDJTIyZ2luZGV4JTIyJTNBJTIyNTM5JTIyJTJDJTIydXJsJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZjb21tdW5pdHkud2l0aGhpdmUuY29tJTJGaGl2ZXNkayUyRmxvZ2luJTJGcmVkaXJlY3QlMjIlMkMlMjJjb3VudHJ5JTIyJTNBJTIyS1IlMjIlMkMlMjJsYW5ndWFnZSUyMiUzQSUyMmtvJTIyJTdE

Response Body

API 호출 시 전달한 리다이렉트 URL에 res라는 값을 쿼리 파라미터 형식으로 붙여 반환합니다. res에 대한 설명은 아래 설명을 확인하세요.

필드명	설명	타입	필수 여부
URL	API 호출 시 전달한 리다이렉트 URL에 쿼리 파라미터 res를 붙인 값	string	Y

Response Sample

// https://community.withhive.com/hivesdk/login/redirect를 리다이렉트 URL로 설정한 경우
https://community.withhive.com/hivesdk/login/redirect?res=JTdCJTIyY29kZSUyMiUzQSUyMjEwMCUyMiUyQyUyMnBpZCUyMiUzQSUyMjIwMDAwMDE0NTQ0JTIyJTJDJTIydG9rZW4lMjIlM0ElMjIxNjg4MTA5MDQ0NTgzLWpmNWJwUjY3MFVMSmhsQlpoVTlUN0IlMjIlN0Q=

Response Body - res res는 아래 키 값으로 구성한 JSON 객체를 URL 인코딩과 BASE64 인코딩을 거쳐 string으로 변환한 값입니다. JSON 객체를 사용하려면, 역으로 BASE64 디코딩과 URL 디코딩을 수행하세요. JSON 객체는 아래와 같습니다.

필드명	설명	타입
code	응답 코드 값(100: 성공)	string
pid	Hive에서 검증받은 Player ID	string
token	Player ID 검증을 위한 토큰	string

Response Sample - res

{
    "code": "100",
    "pid": "20000009891",
    "token": "1627881984263-jkx1B3GOY3EsJ"
}

로그인 페이지 호출하기 v1

로그인 페이지 호출하기 v1¶