Xsolla-logo

サイレント認証

get/social/{cross_social_provider_name}/cross_auth

Exchanges the user JWT from Steam, Xbox, or Epic Games for the JWT in your project (projectId).

You will get the link to redirect the user to your project.

To enable silent authentication, use the instruction.

Request
path Parameters
cross_social_provider_name
required
string

Name of the platform the user authorized in. Can be steam, xbox, epicgames.

query Parameters
projectId
required
string <uuid>

パブリッシャーアカウントからのログインプロジェクトID。

login_url
string

URL to redirect the user to after account confirmation, successful authentication, two-factor authentication configuration, or password reset confirmation. Must be identical to the Callback URL specified in the URL block of Publisher Account. To find it, go to Login > your Login project and select the Callback URLs section in the upper block of the navigation page. Required if there are several Callback URLs.

fields
Array of strings non-empty

ユーザーまたはソーシャルネットワークから追加で要求され、JWTに書き込まれる必要があるパラメータのリスト。パラメータはカンマで区切る必要があります。例えば、email

emailを要求し、ソーシャルネットワークからemail値で応答がなかった時:

  • ログインウィジェットを統合した場合、対応するフォームにメールアドレスを入力するよう要求されます。
  • Login APIを導入した場合、ユーザーには、独自のインターフェースの対応するフォームにメールアドレスを入力するよう求める必要があります。このフォームのURLをアカウントマネージャーに送信してください。

メールアドレスが入力された後、ユーザーはメールアドレス確認メッセージを受け取ります。メール確認を無効にする場合は、アカウントマネージャーまでお問い合わせください。

app_id
string

プラットフォームのアプリID。

payload
string

カスタムデータ。パラメータの値は、ユーザーJWTpayloadクレームで返されます。

with_logout
string
Default: "0"

既存のユーザーJWT値を非アクティブ化し、このコールによって生成されたものをアクティブ化するかどうかを示します。次の値を指定できます。

  • 1 は、既存の値を非アクティブ化し、新しい値をアクティブ化します。
  • 0 は、既存の値をアクティブ化したままにします。
session_ticket
string

プラットフォームから受け取ったセッションチケット。

code
string

プラットフォームから受け取ったコード。

is_redirect
boolean
Default: true

エクソラログインサーバーがどのように応答すべきかを示します。以下の値を設定した場合:

  • true値の場合、エクソラログインサーバーは302応答コードを返します。 ユーザーJWTを使用したユーザーリダイレクトのURLは、Locationヘッダーに含まれます。
  • false値の場合、エクソラログインサーバーは200応答コードを返します。 ユーザーJWTを使用したユーザーリダイレクトのURLは、応答の本文に含まれます。
Responses
200

OK

302

リダイレクション

400

無効なリクエスト

404

見つかりません

422

処理不可能なエンティティー

429

リクエストの回数が多すぎます

Request samples
Response samples
application/json
{
  • "login_url": "string"
}