報酬チェーンを作成する

post/v2/project/{project_id}/admin/reward_chain

報酬チェーンを作成します。

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

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

Example: 44056

Request Body schema: application/json

required

object

アイテム名のローカライズを行ったオブジェクトです。小文字の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
it	string or null
ja	string or null
ko	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

required

object

sku

required

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

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

date_start

required

string <date-time>

報酬チェーンの開始日。

required

Array of objects

Array

required

object

アイテム名のローカライズを行ったオブジェクトです。小文字の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
it	string or null
ja	string or null
ko	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

required

object

amount

required

integer

バリューポイントでのステップ価格。

required

Array of objects

Array

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$ 一意のアイテムID。SKUには、英小文字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。
quantity required	integer アイテム数量。

image_url

string or null

画像URL。

is_enabled

required

boolean

date_end

string or null <date-time>

報酬チェープロモーションが終了する日付。「null」も可能です。date_endがnullの場合、報酬チェーンは時間制限がありません。

object

アイテムの説明用のローカライズされたオブジェクト。小文字の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
it	string or null
ja	string or null
ko	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 or null

画像URL。

object

アイテムの長い説明のためのローカライゼーションを持つオブジェクト。小文字の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
it	string or null
ja	string or null
ko	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

order

integer

配列順序を定義します。

(interval_type = 週次 (object or null)) or (interval_type = 月次 (object or null))

報酬チェーンのリセット期間。

One of:

報酬チェーンの週次更新タイプ。

interval_type required	string 報酬チェーンの反復なリセットの頻度。 Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... 希望するタイムゾーンで報酬チェーンがリセットされる時間（時間数に丸める）。例えば、報酬チェーンのリセットの設定時間は、クアラルンプールのタイムゾーン (GMT+8) の 01:00 です。この場合、`time`パラメータの値は`01:00:00+08:00`となります。
day_of_week required	integer [ 1 .. 7 ] 報酬チェーンがリセットされる曜日。`1`は月曜日、`7`は日曜日。

Responses

201

報酬チェーンが正常に作成されました。

401

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

422

無効なリクエスト。

Request samples

application/json

{"date_end": "2021-04-15T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"description": {"en": "Reward chain description"
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_enabled": true,
"long_description": {"en": "Reward chain long description"
},
"name": {"en": "Reward chain"
},
"order": 1,
"recurrent_schedule": {"day_of_week": 1,
"interval_type": "weekly",
"time": "01:00:00+08:00"
},
"steps": [{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "First step of the reward chain"
},
"price": {"amount": 10
},
"reward": [{"quantity": 5,
"sku": "item_sku_1"
},
{"quantity": 1,
"sku": "item_sku_2"
}
]
},
{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "Second step of the reward chain"
},
"price": {"amount": 15
},
"reward": [{"quantity": 5,
"sku": "item_sku_3"
},
{"quantity": 1,
"sku": "item_sku_4"
}
]
}
],
"value_point": {"sku": "value_point_sku"
}
}

Response samples

application/json

{"reward_chain_id": 10
}