バリューポイントを作成する

Xsolla Developers

または

パブリッシャーアカウントへ

バリューポイントを作成するServer-sideAdmin

post/v2/project/{project_id}/admin/items/value_points

バリューポイントを作成します。

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

Example: 44056

Request Body schema: application/json

sku

required

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

一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。

required

(two-letter (object or null)) or (five-letter (object or null))

アイテム名に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：en）または5文字の言語コード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：enとen-US）、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

One of:

2文字の小文字の言語コード。

ar	string or null アラビア語
bg	string or null ブルガリア語
cn	string or null 中国語（簡体字）
cs	string or null チェコ語
de	string or null ドイツ語
en	string or null 英語
es	string or null スペイン語（スペイン）
fr	string or null フランス語
he	string or null ヘブライ語
id	string or null インドネシア語
it	string or null イタリア語
ja	string or null 日本語
km	string or null クメール語
ko	string or null 韓国語
lo	string or null ラオス語
my	string or null ビルマ語
ne	string or null ネパール語
ph	string or null フィリピン語
pl	string or null ポーランド語
pt	string or null ポルトガル語
ro	string or null ルーマニア語
ru	string or null ロシア語
th	string or null タイ語
tr	string or null トルコ語
tw	string or null 中国語（繁体字）
vi	string or null ベトナム語

(two-letter (object or null)) or (five-letter (object or null))

アイテムの説明に関するローカライズ用オブジェクト。2文字の小文字の言語コード（例：en）または5文字のロケールコード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のオプションが提供された場合（例：enとen-US）、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

One of:

2文字の小文字の言語コード。

ar	string or null アラビア語
bg	string or null ブルガリア語
cn	string or null 中国語（簡体字）
cs	string or null チェコ語
de	string or null ドイツ語
en	string or null 英語
es	string or null スペイン語（スペイン）
fr	string or null フランス語
he	string or null ヘブライ語
id	string or null インドネシア語
it	string or null イタリア語
ja	string or null 日本語
km	string or null クメール語
ko	string or null 韓国語
lo	string or null ラオス語
my	string or null ビルマ語
ne	string or null ネパール語
ph	string or null フィリピン語
pl	string or null ポーランド語
pt	string or null ポルトガル語
ro	string or null ルーマニア語
ru	string or null ロシア語
th	string or null タイ語
tr	string or null トルコ語
tw	string or null 中国語（繁体字）
vi	string or null ベトナム語

image_url

string

画像URL。

is_clan

boolean

バリューポイントがクランリワードチェーンで使用されるかどうか。

is_enabled

boolean

(two-letter (object or null)) or (five-letter (object or null))

アイテムの長文説明のローカライズを含むオブジェクト。2文字の小文字の言語コード（例：en）または5文字のロケールコード（例：en-US）のいずれかの形式で値を受け入れます。どちらの形式も入力として受け入れられますが、応答は2文字の小文字の言語コードを返します。同じ言語に対して両方のバリアント（例：enとen-US）が提供された場合、最後に提供された値が保存されます。サポートされている言語の完全なリストは、ドキュメントで確認できます。

Any of:

2文字の小文字の言語コード。

ar	string or null アラビア語
bg	string or null ブルガリア語
cn	string or null 中国語（簡体字）
cs	string or null チェコ語
de	string or null ドイツ語
en	string or null 英語
es	string or null スペイン語（スペイン）
fr	string or null フランス語
he	string or null ヘブライ語
id	string or null インドネシア語
it	string or null イタリア語
ja	string or null 日本語
km	string or null クメール語
ko	string or null 韓国語
lo	string or null ラオス語
my	string or null ビルマ語
ne	string or null ネパール語
ph	string or null フィリピン語
pl	string or null ポーランド語
pt	string or null ポルトガル語
ro	string or null ルーマニア語
ru	string or null ロシア語
th	string or null タイ語
tr	string or null トルコ語
tw	string or null 中国語（繁体字）
vi	string or null ベトナム語

Array of objects

スクリーンショット、ゲームプレイ動画などのアイテム追加アセット。

Array

type	string メディアタイプ：`image`/`video`。 Enum: "image" "video"
url	string リソースファイル。

order

integer

配列順序を定義します。

Responses

201

バリューポイントは正常に作成されました。

401

基本認証が不合格または不正です。基本認証または正しい認証情報を使用したことを確認してください。

422

無効なリクエストです。

Request samples

application/json

{"description": {"en": "Value points for clan reward system."
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_clan": true,
"is_enabled": true,
"long_description": {"en": "Value points given to clans to get new rewards in a reward chain."
},
"media_list": [ ],
"name": {"en": "Clan Reward VP 1"
},
"order": 3,
"sku": "com.xsolla.clan_value_point_1"
}

Response samples

application/json

{"item_id": 10,
"sku": "com.xsolla.item_new"
}