Créer un lot

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.

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

(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

Array of objects <= 20 items

Liste des attributs.

Attention. La création de plus de 20 attributs pour un objet n'est pas autorisée. Toute tentative de dépassement entraîne une erreur.

Array (<= 20 items)

external_id

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

ID unique de l'attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des tirets et des traits bas.

required

Array of objects

Attention. La création de plus de 6 valeurs pour un attribut n'est pas autorisée. Toute tentative de dépassement entraînera une erreur.

Array

required

object

Default: {"de":"Strategie","en":"Strategy"}

Objet contenant des versions localisées du nom de la valeur. Les clés sont spécifiées selon la norme ISO 3166-1.

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

ID unique de la valeur d'un attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules, des tirets et des tirets bas.

object

Default: {"de":"Genre","en":"Genre"}

Objet contenant des versions localisées du nom de l'attribut. Les clés sont spécifiées selon la norme ISO 3166-1.

property name*

additional property

string

bundle_type

string

Default: "standard"

Type de lot. Utilisez standard pour créer un lot contenant des objets et spécifiez les UGS des objet inclus. Utilisez partner_side_content pour créer un lot vide auquel vous ajouterez des objets de votre côté via un webhook. Ce type est réservé à la Personnalisation du catalogue côté partenaire.

Enum: "standard" "partner_side_content"

Array of objects non-empty

Array (non-empty)

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	integer >= 1 Default: 1 Quantité des objets sélectionnés dans le lot.

custom_attributes

object <json> <= 500 characters

Un JSON contenant les attributs de l'objet et leurs valeurs. Les attributs permettent d'ajouter des informations supplémentaires aux objets, telles que le niveau requis du joueur pour utiliser l'objet. Les attributs enrichissent la logique interne de votre jeu et sont accessibles via des méthodes GET et des webhooks spécifiques.

groups

Array of strings

Default: []

Groupes auxquels l'objet appartient.

Note. La valeur de la chaîne correspond à l'`external_id` du groupe.

image_url

string or null

URL de l'image.

is_enabled

boolean

Default: true

Si ce paramètre est désactivé, l'objet ne peut pas être trouvé ni acheté.

is_free

boolean

Default: false

Si ce paramètre est défini sur true, l'objet est gratuit.

is_show_in_store

boolean

Default: false

L'objet est disponible à l'achat.

object

Limites d'objets.

per_item

integer or null

Limites globales d'objets.

per_user

integer or null

Limites d'objets 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.

interval_type required	string Délai d'actualisation récurrent. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Heure d'actualisation des limites dans le fuseau horaire souhaité (arrondie en heures).

(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

Array of objects or null

Ressources supplémentaires du lot.

Array

type	string Type de média : `image`/`video`. Enum: "image" "video"
url	string Fichier de ressources.

order

integer

Default: 1

Ordre de priorité des lots dans la liste.

Array of objects or null

Période de vente d'objets.

Array

date_from	string <date-time> Date de mise en vente de l'objet spécifié.
date_until	string or null <date-time> Date de retrait de la vente de l'objet spécifié. Peut prendre la valeur `null`.

Array of objects

Prix en devises réelles.

Array

amount required	string^\d\.?\d$ Prix de l'objet.
currency required	string Devise du prix de l'article. Code à trois lettres selon ISO 4217.
is_default required	boolean Le prix par défaut est utilisé pour constituer le catalogue si aucun prix n'est spécifié dans la devise de l'utilisateur.
is_enabled required	boolean Le prix est activé.
country_iso	string or null Pays où ce prix est disponible. Code à deux lettres selon la norme ISO 3166-1 alpha 2.

Array of objects

Array

id	integer >= 1

Array of objects or null

Array

amount required	integer
is_default required	boolean
is_enabled required	boolean
sku	string 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.

Responses

201

Le lot a été créé 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

{"attributes": [{"external_id": "class",
"name": {"en": "Class"
},
"values": [{"external_id": "soldier",
"value": {"en": "Soldier"
}
},
{"external_id": "officer",
"value": {"en": "Officer"
}
}
]
}
],
"content": [{"quantity": 1,
"sku": "com.xsolla.iron_gloves_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_boots_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_shield_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_armour_1"
},
{"quantity": 1,
"sku": "com.xsolla.iron_helmet_1"
}
],
"custom_attributes": {"purchased": 0,
"type": "lootbox"
},
"description": {"de": "Brustpanzer für Soldaten",
"en": "Chest of armour for soldiers"
},
"groups": ["chests"
],
"image_url": "https://picture.bundle-with-many-stuff.png",
"is_enabled": true,
"is_free": true,
"limits": {"per_item": null,
"per_user": null
},
"long_description": {"de": "Brustpanzer für Soldaten",
"en": "Chest of armour for soldiers"
},
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"name": {"de": "Brustpanzer",
"en": "Chest of armour"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": "9.99",
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": "9.99",
"currency": "EUR",
"is_default": false,
"is_enabled": true
}
],
"sku": "com.xsolla.armour_chest_1",
"vc_prices": [ ]
}

Response samples

application/json

{"sku": "com.xsolla.kg_1"
}