Xsolla-logoXsolla Developers
ou
Vers le Compte éditeur

Créer une chaîne de récompensesServer-sideAdmin

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
One of:

Chaîne de récompenses.

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

Conteneur objet contenant les localisations du nom de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la documentation pour la liste complète des langues prises en charge.

One of:

Codes de langue à deux lettres minuscules.

ar
string or null

Arabe

bg
string or null

Bulgare

cn
string or null

Chinois (simplifié)

cs
string or null

Tchèque

de
string or null

Allemand

en
string or null

Anglais

es
string or null

Espagnol (Espagne)

fr
string or null

Français

he
string or null

Hébreu

id
string or null

Indonésien

it
string or null

Italien

ja
string or null

Japonais

km
string or null

Khmer

ko
string or null

Coréen

lo
string or null

Laotien

my
string or null

Birman

ne
string or null

Népalais

ph
string or null

Philippin

pl
string or null

Polonais

pt
string or null

Portugais

ro
string or null

Roumain

ru
string or null

Russe

th
string or null

Thaï

tr
string or null

Turc

tw
string or null

Chinois (traditionnel)

vi
string or null

Vietnamien

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 et majuscules, 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
(two-letter (object or null)) or (five-letter (object or null))

Conteneur objet contenant les localisations du nom de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la documentation pour la liste complète des langues prises en charge.

One of:

Codes de langue à deux lettres minuscules.

ar
string or null

Arabe

bg
string or null

Bulgare

cn
string or null

Chinois (simplifié)

cs
string or null

Tchèque

de
string or null

Allemand

en
string or null

Anglais

es
string or null

Espagnol (Espagne)

fr
string or null

Français

he
string or null

Hébreu

id
string or null

Indonésien

it
string or null

Italien

ja
string or null

Japonais

km
string or null

Khmer

ko
string or null

Coréen

lo
string or null

Laotien

my
string or null

Birman

ne
string or null

Népalais

ph
string or null

Philippin

pl
string or null

Polonais

pt
string or null

Portugais

ro
string or null

Roumain

ru
string or null

Russe

th
string or null

Thaï

tr
string or null

Turc

tw
string or null

Chinois (traditionnel)

vi
string or null

Vietnamien

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 et majuscules, des points, des tirets et des traits bas.

quantity
required
integer

Quantité de l'objet.

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]+$

Code d'attribut utilisateur.

operator
required
string

Type d'opération effectuée par la condition. Pour le type d'attribut string.

Enum: Description
eq

Égal

ne

Différent de

value
required
string <= 255 characters

Valeur de la condition à laquelle la valeur de l'attribut utilisateur sera comparée. Le type dépend du type d'attribut.

type
required
string

Type d'attribut utilisateur.

Value: "string"
can_be_missing
boolean

Indique que la condition est remplie même si l'attribut est absent des attributs de l'utilisateur. Passez true pour afficher l'objet pour les utilisateurs ne possédant pas cet attribut. Les utilisateurs ayant l'attribut, mais dont la valeur ne correspond pas à celle définie dans la condition ne verront pas l'objet. Si vous passez false, les utilisateurs dont l'attribut est manquant ou dont la valeur ne correspond pas à celle spécifiée dans la condition ne verront pas l'objet.

image_url
string or null

URL de l'image.

is_enabled
required
boolean
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]+$

Code d'attribut utilisateur.

operator
required
string

Type d'opération effectuée par la condition. Pour le type d'attribut string.

Enum: Description
eq

Égal

ne

Différent de

value
required
string <= 255 characters

Valeur de la condition à laquelle la valeur de l'attribut utilisateur sera comparée. Le type dépend du type d'attribut.

type
required
string

Type d'attribut utilisateur.

Value: "string"
can_be_missing
boolean

Indique que la condition est remplie même si l'attribut est absent des attributs de l'utilisateur. Passez true pour afficher l'objet pour les utilisateurs ne possédant pas cet attribut. Les utilisateurs ayant l'attribut, mais dont la valeur ne correspond pas à celle définie dans la condition ne verront pas l'objet. Si vous passez false, les utilisateurs dont l'attribut est manquant ou dont la valeur ne correspond pas à celle spécifiée dans la condition ne verront pas l'objet.

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.

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

Conteneur objet contenant les localisations de la description de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la documentation pour la liste complète des langues prises en charge.

One of:

Codes de langue à deux lettres minuscules.

ar
string or null

Arabe

bg
string or null

Bulgare

cn
string or null

Chinois (simplifié)

cs
string or null

Tchèque

de
string or null

Allemand

en
string or null

Anglais

es
string or null

Espagnol (Espagne)

fr
string or null

Français

he
string or null

Hébreu

id
string or null

Indonésien

it
string or null

Italien

ja
string or null

Japonais

km
string or null

Khmer

ko
string or null

Coréen

lo
string or null

Laotien

my
string or null

Birman

ne
string or null

Népalais

ph
string or null

Philippin

pl
string or null

Polonais

pt
string or null

Portugais

ro
string or null

Roumain

ru
string or null

Russe

th
string or null

Thaï

tr
string or null

Turc

tw
string or null

Chinois (traditionnel)

vi
string or null

Vietnamien

image_url
string or null

URL de l'image.

is_always_visible
boolean
Default: true

Détermine la visibilité de la chaîne de récompenses pour tous les utilisateurs :

  • Si true, la chaîne s'affiche toujours, indépendamment du statut d'authentification ou des attributs de l'utilisateur.
  • Si false, la chaîne s'affiche uniquement si aucune chaîne de récompenses personnalisée ne correspond ; par exemple, si l'utilisateur n'est pas authentifié ou si ses attributs ne correspondent à aucune chaîne personnalisée.

que dans le cadre des chaînes de récompenses personnalisées et uniquement si le tableau attribute_conditions n'est pas transmis.

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

Conteneur objet contenant les localisations de la description complète de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la documentation pour la liste complète des langues prises en charge.

Any of:

Codes de langue à deux lettres minuscules.

ar
string or null

Arabe

bg
string or null

Bulgare

cn
string or null

Chinois (simplifié)

cs
string or null

Tchèque

de
string or null

Allemand

en
string or null

Anglais

es
string or null

Espagnol (Espagne)

fr
string or null

Français

he
string or null

Hébreu

id
string or null

Indonésien

it
string or null

Italien

ja
string or null

Japonais

km
string or null

Khmer

ko
string or null

Coréen

lo
string or null

Laotien

my
string or null

Birman

ne
string or null

Népalais

ph
string or null

Philippin

pl
string or null

Polonais

pt
string or null

Portugais

ro
string or null

Roumain

ru
string or null

Russe

th
string or null

Thaï

tr
string or null

Turc

tw
string or null

Chinois (traditionnel)

vi
string or null

Vietnamien

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

Demande non valide.

Request samples
application/json
{}
Response samples
application/json
{
  • "reward_chain_id": 10
}