La promotion ajoute des objets bonus gratuits à l'achat effectué par l'utilisateur.
La promotion peut être appliquée à chaque achat au sein d'un projet ou à un achat comprenant des objets particuliers.
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
Array of objects or null
Ensemble d'objets devant être inclus dans l'achat pour l'application d'une promotion. Si ce paramètre est défini sur null, la promotion s'applique à tous les achats effectués dans au sein du projet.
Array
sku
string
Default: "elven_sword"
UGS de l'objet.
required
Array of objects or null
Array
quantity
number
Default: 1
Quantité de l'objet.
sku
string
Default: "elven_shield"
UGS de l'objet.
required
object
Nom de la promotion. Doit comprendre des paires clé/valeur, où la clé est une région au format "^[a-z]{2}-[A-Z]{2}$", la valeur est une chaîne.
property name*
additional property
string
Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)
One of:
Conditions comparées aux valeurs des attributs utilisateur.
Toutes les conditions doivent être remplies pour que l'action ait un effet.
[ 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"
date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"
Date de fin de la promotion. Peut prendre la valeur null. Si date_end est défini sur null, la promotion sera illimitée dans le temps.
date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"
Date de début de la promotion.
id
integer
ID de la promotion. Identifiant unique de la promotion au sein du projet.
object
Limites de la promotion.
per_user
integer or null
Limites de la promotion pour un utilisateur spécifique.
object or null
Délai d'actualisation des limites.
interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)
One of:
Type quotidien d'actualisation des limites pour l'utilisateur.
Heure d'actualisation des limites dans le fuseau horaire souhaité (arrondie en heures).
Responses
201
La promotion 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.