Xsolla-logo
  • 文档
  • 创建帐户

创建游戏

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

在项目中创建游戏。

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 44056
Request Body schema: application/json

包含游戏数据的对象。

sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

唯一商品ID。 SKU只能包含小写英文字母和数字字符、句点、破折号和下划线。

required
object

包含本地化商品名称的对象。两个小写字母的语言代码。

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

用于不同DRM的游戏密钥。

Array
sku
required
string [ 1 .. 255 ] characters

唯一商品ID。 SKU只能包含小写英文字母和数字字符、句点、破折号和下划线。

drm_sku
required
string

DRM唯一ID。

required
Array of objects

以真实货币表示的价格。

Array
amount
required
number
currency
required
string

默认购买货币。符合ISO 4217的三字母代码。

is_default
required
boolean

如果未指定以用户货币为单位的价格，则使用默认价格来生成目录。

is_enabled
required
boolean
Array of objects

属性列表。

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

唯一属性ID。 external_id只能包含小写英文字母和数字字符、破折号和下划线。

required
Array of objects
Array
required
object
Default: {"de":"Strategie","en":"Strategy"}

包含本地化值名称的对象。编码按照ISO 3166-1的规定。

property name*
additional property
string
external_id
required
string [ 1 .. 255 ] characters ^[-_.\d\w]+$

属性的唯一值ID。 external_id只能包含小写英文字母和数字字符、破折号和下划线。

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

包含本地化属性名称的对象。编码按照ISO 3166-1的规定。

property name*
additional property
string
Array of objects

商品所属分组。

Array
external_id
required
string
is_enabled
boolean

如果禁用，则无法通过物品库购买和访问商品。

is_free
boolean
Default: false

如果为true，则该商品为免费。

is_show_in_store
boolean

商品可供购买。

object

商品限制。

per_item
integer or null

全局商品限制。

per_user
integer or null

用于单独用户的商品限制。

object or null

限制次数刷新周期。

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)
One of:

每天类型的用户限制次数刷新。

interval_type
required
string

循环刷新周期。

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

所需时区的限制次数刷新时间（四舍五入到小时）。

object

包含本地化商品名称的对象。两个小写字母的语言代码。

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

列表中的游戏顺序优先级。

Array of objects or null

商品促销时间段。

Array
date_from
string <date-time>

指定商品促销开始的日期。

date_until
string or null <date-time>

指定商品停止促销的日期。可以为null。

object

预订设置。

release_date
required
string

游戏密钥发行日期按照ISO 8601规定的格式。

is_enabled
required
boolean

如果禁用，则该商品不是预订商品。

description
string

预订的附加信息，将通过电子邮件发送。

Array of objects
Array
id
integer
Array of objects
Array
amount
required
number
is_default
required
boolean
is_enabled
required
boolean
sku
string

唯一商品ID。 SKU只能包含小写英文字母和数字字符、句点、破折号和下划线。

Array of objects <= 20 items

属性列表。

注意：为每个商品指定的属性不能超过20个。任何超出限制的尝试都会导致错误。
Array (<= 20 items)
external_id
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

唯一属性ID。 external_id只能包含小写英文字母和数字字符、破折号和下划线。

required
Array of objects
注意：为每个属性创建的值不能超过6个。任何超出限制的尝试都会导致错误。
Array
required
object
Default: {"de":"Strategie","en":"Strategy"}

包含本地化值名称的对象。编码按照ISO 3166-1的规定。

property name*
additional property
string
external_id
required
string [ 1 .. 255 ] characters ^[-_.\d\w]+$

属性的唯一值ID。 external_id只能包含小写英文字母和数字字符、破折号和下划线。

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

包含本地化属性名称的对象。编码按照ISO 3166-1的规定。

property name*
additional property
string
object

包含本地化商品描述的对象。两个小写字母的语言代码。

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

商品所属分组。

Array
external_id
required
string
image_url
string

图像URL。

is_enabled
boolean

如果禁用，则无法通过物品库购买和访问商品。

is_show_in_store
boolean

商品可供购买。

object

包含本地化商品长描述的对象。两个小写字母的语言代码。

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

游戏附加资源，例如屏幕截图、游戏视频等。

Array
type
string

媒体类型：image/video。

Enum: "image" "video"
url
string

资源文件。

order
integer

列表中的游戏顺序优先级。

Responses
201

游戏创建成功。

401

基本认证未通过或错误。确保您使用了基本认证或正确的凭据。

422

无效的请求。

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.