Xsolla-logo

Create reward chainServer-sideAdmin

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

Creates reward chain.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Example: 44056
Request Body schema: application/json
One of:

Eine Belohnungskette.

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
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.

Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)
One of:
[ 1 .. 100 ] items
Array ([ 1 .. 100 ] items)
attribute
required
string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

Benutzerattributcode.

operator
required
string

Art der durchgeführten Operation nach Bedingung. Für den Attributtyp string.

Enum: Description
eq

Gleich

ne

Ungleich

value
required
string <= 255 characters

Bedingungswert, mit dem der Benutzerattributwert verglichen wird. Der Typ hängt vom Attributtyp ab.

type
required
string

Benutzerattributtyp.

Value: "string"
can_be_missing
boolean

Gibt an, dass die Bedingung erfüllt ist, auch wenn das Attribut in den Benutzerattributen fehlt. Übermitteln Sie true, um den Artikel den Nutzern anzuzeigen, die dieses Attribut nicht haben. Nutzer, die das Attribut haben, dessen Wert jedoch nicht mit dem in der Bedingung angegebenen Wert übereinstimmt, sehen den Artikel nicht. false – Nutzer, die das Attribut haben, dessen Wert jedoch nicht mit dem in der Bedingung angegebenen Wert übereinstimmt oder bei denen das Attribut fehlt, sehen den Artikel nicht.

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
{}
Response samples
application/json
{
  • "reward_chain_id": 10
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.