로그인 페이지 호출하기 v1

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

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

 

  • 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
  • Response Body

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

    필드명 설명 타입 필수 여부
    URL API 호출 시 전달한 리다이렉트 URL에 쿼리 파라미터 res를 붙인 값 string Y
  • Response Sample
  • 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