Créer une chaîne de récompenses

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

Crée une chaîne de récompenses.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.

Example: 44056

Request Body schema: application/json

required

object

Objet contenant les versions localisées du nom de l'objet. Code de langue à deux lettres minuscules.

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 unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.

date_start

required

string <date-time>

Date de début de la chaîne de récompenses.

required

Array of objects

Array

required

object

Objet contenant les versions localisées du nom de l'objet. Code de langue à deux lettres minuscules.

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

Prix de l'étape en points de valeur.

required

Array of objects

Array

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$ ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.
quantity required	integer Quantité de l'objet.

image_url

string or null

URL de l'image.

is_enabled

required

boolean

date_end

string or null <date-time>

Date de fin de la promotion de chaîne de récompenses. Peut prendre la valeur null. Si date_end est défini sur null, la chaîne de récompenses sera illimitée dans le temps.

object

Objet contenant les versions localisées de la description de l'objet. Code de langue à deux lettres minuscules.

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 de l'image.

object

Objet contenant les versions localisées de la description détaillée de l'objet. Code de langue à deux lettres minuscules.

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

Définit l'ordre d'empilement.

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

Période de réinitialisation récurrente de la chaîne de récompenses.

One of:

Type hebdomadaire d'actualisation de la chaîne de récompenses.

interval_type required	string Fréquence de la réinitialisation récurrente de la chaîne de récompenses. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Heure à laquelle la chaîne de récompenses est réinitialisée dans le fuseau horaire souhaité (arrondie aux heures). Par exemple, l'heure de réinitialisation de la chaîne de récompenses est fixée à 01:00 pour le fuseau horaire de Kuala Lumpur (GMT+8). Dans ce cas, la valeur du paramètre `time` est `01:00:00+08:00`.
day_of_week required	integer [ 1 .. 7 ] Jour de la semaine où la chaîne de récompense est réinitialisée, où `1` est le lundi et `7`, le dimanche.

Responses

201

La chaîne de récompenses a été créée avec succès.

401

L'authentification de base n'a pas été passée ou est incorrecte. Vérifiez que vous avez utilisé l'authentification de base ou des informations d'identification correctes.

422

Requête non valide.

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
}