ログインページ v2 を読み込む

ログインページを読み込む v2¶

このAPIは、ユーザーが実際にログインできるウェブログインのためのURLアドレスをロードします。ユーザーがログインすると、アプリ開発者によって設定されたリダイレクトURL、state、およびロジック検証のための認証トークンが返されます。サポートされているIdPアカウントは、Hive、Google、Facebook、およびAppleアカウントです。

• リクエスト URL

  商用サーバーのURL	https://weblogin.withhive.com/login?param=
  サンドボックスURL	https://sandbox-weblogin.withhive.com/login?param=

• リクエスト ヘッダー

  HTTPメソッド	GET
  コンテンツタイプ	text/html

• クエリ パラメータ

  フィールド名	タイプ	説明	必須
  param	文字列	paramの文字列値は、以下の表のキー値から構成されるJSONデータのURLエンコーディングとBASE64エンコーディングを通じて作成されます。	Y

• クエリ パラメータ - param

  フィールド名	タイプ	説明
  appid	文字列	Hive サーバーによって使用されるアプリケーションID
  gindex	文字列	Hive サーバーによって使用されるゲームインデックス情報。 App Center > Game List > あなたのゲームを検索 and click it > Click the AppID tab > ゲームのs AppIDをクリック > Check 基本情報タブでゲームインデックスを取得します。
  url	string	これはユーザーログイン完了後にリダイレクトされるURLアドレスです。Hive コンソールで設定されたリダイレクトURLと同じURLである必要があります。
  国	文字列	ゲームまたはコミュニティによって設定された国コード。 この値が提供されていない場合、ウェブブラウザのデフォルト値が使用されます。
  言語	文字列	ゲームまたはコミュニティによって設定された言語コードです。この値が提供されていない場合、ウェブブラウザのデフォルト値が使用されます。

• リクエスト 例<

  // 元のパラメータはJSONオブジェクトで構成されています。このJSONオブジェクトに対してURLエンコーディングとBASE64エンコーディングを順次実行して得られた文字列値が、APIを呼び出す際のクエリパラメータとして使用されます。
  {
          "appid":"com.com2us.hivesdk.ios.community.global.normal",
          "gindex":"539",
          "url":"https://community.withhive.com/hivesdk/login/redirect",
          "country":"KR",
          "language":"ko"
  }
  

  // APIを呼び出し、エンコードされたパラメータをリクエストURLのクエリパラメータとして添付します。
  https://weblogin.withhive.com/login?param=JTdCJTIyYXBwaWQlMjIlM0ElMjJjb20uY29tMnVzLmhpdmVzZGsuaW9zLmNvbW11bml0eS5nbG9iYWwubm9ybWFsJTIyJTJDJTIyZ2luZGV4JTIyJTNBJTIyNTM5JTIyJTJDJTIydXJsJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZjb21tdW5pdHkud2l0aGhpdmUuY29tJTJGaGl2ZXNkayUyRmxvZ2luJTJGcmVkaXJlY3QlMjIlMkMlMjJjb3VudHJ5JTIyJTNBJTIyS1IlMjIlMkMlMjJsYW5ndWFnZSUyMiUzQSUyMmtvJTIyJTdE
  

• レスポンス ボディ

  APIリクエストで提供されたリダイレクトURLを、クエリパラメータとして“res”を付加して返します。resの説明については以下の説明を参照してください。

  フィールド名	説明	タイプ	必須
  URL	APIリクエストで提供されたリダイレクトURLで、“res”がクエリパラメータとして付加されています	文字列	Y

• Response Sample<

  // https://community.withhive.com/hivesdk/login/redirectがリダイレクトURLとして設定されていた場合
  https://community.withhive.com/hivesdk/login/redirect?res=JTdCJTIyY29kZSUyMiUzQSUyMjEwMCUyMiUyQyUyMnN0YXRlJTIyJTNBJTIyMTY4ODEwODkyNzk0Mi1CUHVxcHFFaUd6S0lIJTIyJTdE
  

• レスポンス ボディ - res

  resは、以下のキー値で構成されたJSONオブジェクトを、URLエンコーディングとBASE64エンコーディングを介して文字列に変換することによって取得されます。JSONオブジェクトを使用するには、BASE64デコードを行い、その後にURLデコードを行います。JSONオブジェクトは以下に示されています。

  フィールド名	説明	タイプ
  code	レスポンスコード (100: 成功)	string
  state	Verification v2で使用されるトークン	string

• レスポンス サンプル - res<

  {
          "code": "100",
          "state": "1627881984263-jkx1B3GOY3EsJ"
  }