Create reward chain

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_\\-–.]*$

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

date_start

required

string <date-time>

Date when your reward chain starts.

required

Array of objects

Array

required

object

Objekt mit lokalisierten Namen des Artikels. Sprachencode bestehend aus zwei Kleinbuchstaben.

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

Step price in value points.

required

Array of objects

Array

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$ Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.
quantity required	integer Item quantity.

image_url

string or null

Bild-URL.

is_enabled

required

boolean

date_end

string or null <date-time>

Date when your reward chain promotion ends. Can be null. If date_end is null, the reward chain will be unlimited by time.

object

Objekt mit lokalisierten Beschreibungen des Artikels. Sprachencode bestehend aus zwei Kleinbuchstaben.

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

Bild-URL.

object

Objekt mit lokalisierten langen Beschreibungen des Artikels. Sprachencode bestehend aus zwei Kleinbuchstaben.

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

Definiert die Anordnungsreihenfolge.

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null))

Wiederkehrender Reset-Zeitraum der Belohnungskette.

One of:

Belohnungskette wird wöchentlich zurückgesetzt.

interval_type required	string Frequency of the recurrent reset of the reward chain. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Zu welcher Uhrzeit die Belohnungskette in der gewünschten Zeitzone zurückgesetzt wird (auf volle Stunden gerundet). Beispiel: Es ist festgelegt, dass in der Zeitzone Kuala Lumpur (GMT+8) die Belohungskette um 01:00 Uhr zurückgesetzt wird. In diesem Fall lautet der Wert des Parameters `time`: "01:00:00+08:00".
day_of_week required	integer [ 1 .. 7 ] Wochentag, an dem die Belohnungskette zurückgesetzt wird, wobei "1" für Montag und "7" für Sonntag steht.

Responses

201

Reward chain was successfully created.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

422

Ungültige Anfrage.

Request samples

application/json

{"clan_type": "guild",
"date_end": "2021-04-15T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"description": {"en": "Clan reward chain description."
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_enabled": true,
"long_description": {"en": "Clan reward chain long description."
},
"name": {"en": "Clan reward chain"
},
"order": 1,
"popup_header": {"en": "How to unlock rewards"
},
"popup_image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"popup_instruction": {"en": "You must be a clan member to get clan rewards. You join a clan when a clan member invites you to the clan, and you accept the invite. You can also create your own clan."
},
"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": "clan_value_point_sku_1"
}
}

Response samples

application/json

{"reward_chain_id": 10
}