로그인 페이지 호출하기 V2

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

 

  • 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
    state 검증 v2에서 사용할 토큰 string
  • Response Sample – res