Créer un package de monnaie virtuelle

post/v2/project/{project_id}/admin/items/virtual_currency/package

Crée un package de monnaie virtuelle.

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

Any of:

required

Array of objects

Array

amount required	number > 0 Montant.
currency required	string Devise d'achat par défaut. Code de devise à trois lettres selon la norme ISO 4217.
country_iso	string or null Pays où ce prix est disponible. Code à deux lettres selon la norme ISO 3166-1 alpha 2.
is_default	boolean Default: false
is_enabled	boolean Default: true

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

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

required

Array of objects = 1 characters

Le package de monnaie virtuelle ne doit contenir qu'une seule position de monnaie virtuelle.

Array

quantity	integer
sku	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.

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

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

Groupes auxquels l'objet appartient.

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

image_url

string

is_deleted

boolean

is_enabled

boolean

is_free

boolean

Default: false

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

is_show_in_store

boolean

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 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 de l'objet, 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

Définit l'ordre d'empilement.

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

release_date required	string or null <date-time>
is_enabled required	boolean
description	string or null

Array of objects

Array

id	integer >= 1

Array of objects

Array

amount required	integer
is_default required	boolean Default: false
is_enabled required	boolean Default: false Le prix est activé.
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.

Responses

201

L'objet virtuel 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

{"attributes": [{"external_id": "event",
"name": {"en-US": "Event"
},
"values": [{"external_id": "10-anniversary",
"value": {"en-US": "10th anniversary"
}
},
{"external_id": "christmas",
"value": {"en-US": "Christmas"
}
}
]
}
],
"content": [{"quantity": 500,
"sku": "novigrad_crown"
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": {"en-US": "The Crown (also known as the Novigradian crown) is a monetary unit which is used in some Northern Kingdoms",
"ru-RU": "Крона (Также известна как Новиградская крона) - платежная единица, используемая в северных королевствах"
},
"groups": ["witcher"
],
"image_url": "https://vignette.wikia.nocookie.net/witcher/images/7/7c/Items_Orens.png/revision/latest?cb=20081113120917",
"is_enabled": true,
"is_free": false,
"limits": {"per_item": null,
"per_user": null
},
"long_description": {"en-US": "Long Test new",
"ru-RU": "Длинное описание"
},
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"name": {"en-US": "500x Novigradian crown",
"ru-RU": "500x Новиградских крон"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 99.99,
"currency": "USD",
"is_default": true
},
{"amount": 80.03,
"currency": "EUR",
"is_enabled": false
}
],
"sku": "novigrad_crown_500",
"vc_prices": null
}

Response samples

application/json

{"sku": "new-sku"
}