コンテンツにスキップ

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

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

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

私たちは、Hive SDKを使用してアプリを開発した場合、Web Login V1 APIの使用を推奨しません。 これは、PlayerIDがゲームプレイの記録を含むため、ユーザーがWeb Login V1で以前にログインしたアカウントを、現在ゲームにログインしているアカウントにリンクしようとすると、アカウントの競合が発生する可能性があるためです。

Note

Web Login V1を使用するには、まずHiveコンソールApp Centerで関連設定を完了する必要があります。詳細については、コンソールガイドを確認してください。

 

  • リクエスト 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 サーバーで使用されるゲームインデックス情報。 アプリ センター > ゲーム リスト > ゲームを検索 し て クリック し て > AppID タブ > ゲームのAppIDをクリック > 基本情報タブを確認してゲームインデックスを取得します。
    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=JTdCJTIyY29kZSUyMiUzQSUyMjEwMCUyMiUyQyUyMnBpZCUyMiUzQSUyMjIwMDAwMDE0NTQ0JTIyJTJDJTIydG9rZW4lMjIlM0ElMjIxNjg4MTA5MDQ0NTgzLWpmNWJwUjY3MFVMSmhsQlpoVTlUN0IlMjIlN0Q=
  • レスポンス ボディ - res

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

    フィールド名 説明 タイプ
    code レスポンスコード (100: 成功) string
    pid Hive サーバーによって検証されたプレイヤーID string
    token プレイヤーIDの検証用トークン string
  • レスポンス サンプル - res 
    {
        "code": "100",
        "pid": "20000009891",
        "token": "1627881984263-jkx1B3GOY3EsJ"
}