Xsolla-logo

資格付与(管理者)Server-sideAdmin

post/v2/project/{project_id}/admin/entitlement/grant

ユーザーに権利を付与します。

注意

ゲームコードやDRM-freeプラットフォームのゲームのみ付与可能です。
SecuritybasicAuth
Request
path Parameters
project_id
required
integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

Example: 44056
Request Body schema: application/json
user_external_id
required
string

一意のユーザー識別子。

required
object

ゲームプロパティを持つオブジェクト。

sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

一意のキーパッケージID。

required
object

DRMプロパティを持つオブジェクト。

sku
required
string

一意のDRM ID。

Enum: "steam" "playstation" "xbox" "uplay" "origin" "drmfree" "gog" "epicgames" "nintendo_eshop" "discord_game_store" "oculus" "rockstar" "viveport" "stadia"
mode
required
string

どのような種類の資格を付与するかを指定します。このパラメータがsandboxに設定されている場合、サンドボックスモードのユーザーにエンタイトルメントが付与されます。パラメータにdefaultが設定されている場合、エンタイトルメントはライブモードでユーザーに付与されます。

Enum: "default" "sandbox"
code
string or null

ゲームのゲームコード。

user_country
string or null

ユーザーの国。

Responses
200

資格が付与されました。

403

認証ヘッダーが送信されていません。

404

ゲームコードが見つかりません。codeproject_id が正しいことを確認してください。

422

無効なリクエスト。

Request samples
application/json
{
  • "code": "AAAA-BBBB-CCCC-DDDD",
  • "drm": {
    },
  • "game": {
    },
  • "mode": "default",
  • "user_country": "US",
  • "user_external_id": "user-external-id"
}
Response samples
application/json
{
  • "errorCode": 0,
  • "errorMessage": "Authorization header not sent",
  • "statusCode": 403
}