Xsolla-logo

Créer un jeuServer-sideAdmin

post/v2/project/{project_id}/admin/items/game

Crée un jeu dans le projet.

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

Objet contenant des données de jeu.

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.

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
Array of objects

Clés de jeu pour différents DRM.

Array
sku
required
string [ 1 .. 255 ] characters

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.

drm_sku
required
string

ID unique du DRM.

required
Array of objects

Prix en devises réelles.

Array
amount
required
number
currency
required
string

Devise du prix de l'article. Code à trois lettres selon ISO 4217. Consultez la documentation pour obtenir des informations détaillées sur les devises prises en charge par Xsolla.

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
Array of objects

Liste des attributs.

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

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

required
Array of objects
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
Array of objects

Groupes auxquels l'objet appartient.

Array
external_id
required
string
is_enabled
boolean

Si ce paramètre est désactivé, l'objet ne peut pas être acheté et n'est pas accessible par le biais de l'inventaire.

is_free
boolean
Default: false

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

is_show_in_store
boolean

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

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
order
integer

Ordre de priorité des jeux 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.

object

Paramètres de pré-commande.

release_date
required
string

Date de publication de la clé de jeu au format ISO 8601.

is_enabled
required
boolean

Si ce paramètre est désactivé, l'objet n'est pas une pré-commande.

description
string

Informations supplémentaires pour la pré-commande, qui sera envoyée par e-mail.

Array of objects
Array
id
integer
Array of objects
Array
amount
required
number
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, des points, des tirets et des traits bas.

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 paramètre external_id ne peut comprendre que des caractères alphanumériques latins minuscules, 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
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
Array of objects

Groupes auxquels l'objet appartient.

Array
external_id
required
string
image_url
string

URL de l'image.

is_enabled
boolean

Si ce paramètre est désactivé, l'objet ne peut pas être acheté et n'est pas accessible par le biais de l'inventaire.

is_show_in_store
boolean

L'objet est disponible à l'achat.

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
Array of objects

Ressources supplémentaires du jeu, telles que des captures d'écran, des vidéos de gameplay, etc.

Array
type
string

Type de média : image/video.

Enum: "image" "video"
url
string

Fichier de ressources.

order
integer

Ordre de priorité des jeux dans la liste.

Responses
201

Le jeu 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

Requête non valide.

Request samples
application/json
{
  • "description": {
    },
  • "groups": [
    ],
  • "image_url": "http://image.png",
  • "is_enabled": true,
  • "is_show_in_store": true,
  • "long_description": {
    },
  • "media_list": [],
  • "name": {
    },
  • "sku": "game_1",
  • "unit_items": [
    ]
}
Response samples
application/json
{
  • "item_id": 101,
  • "sku": "game_1"
}
System statusAll services operational

Privacy Settings

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