Xsolla-logo

Criar jogoServer-sideAdmin

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

Cria um jogo no projeto.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Example: 44056
Request Body schema: application/json

Objeto com dados de jogo.

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

ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, pontos, traços e sublinhados.

required
object

Objeto com traduções para o nome do item. Código de idioma de duas letras minúsculas.

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

Chaves de jogo para diferentes DRMs.

Array
sku
required
string [ 1 .. 255 ] characters

ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, pontos, traços e sublinhados.

drm_sku
required
string

ID de DRM exclusivo.

required
Array of objects

Preços em moedas reais.

Array
amount
required
number
currency
required
string

Moeda de compra padrão. Código de três letras de acordo com o formato ISO 4217. Consulte a documentação para obter informações detalhadas sobre as moedas suportadas pela Xsolla.

is_default
required
boolean

O preço padrão é usado para criar o catálogo se nenhum preço for especificado na moeda do usuário.

is_enabled
required
boolean
Array of objects

Lista de atributos.

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

ID de atributo exclusivo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

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

Objeto com traduções do nome do valor. As chaves são especificadas no formato ISO 3166-1.

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

ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

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

Objeto com localizações para o nome do atributo. As chaves são especificadas no formato ISO 3166-1.

property name*
additional property
string
Array of objects

Grupo aos quais o item pertence.

Array
external_id
required
string
is_enabled
boolean

Se desabilitado, o item não poderá ser comprado nem acessado pelo inventário.

is_free
boolean
Default: false

Se true, o item é gratuito.

is_show_in_store
boolean

O item está disponível para compra.

object

Limites de itens.

per_item
integer or null

Limitação global de itens.

per_user
integer or null

Limitação de item para um usuário separado.

object or null

Limite o período de atualização.

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

Tipo diário de atualização de limites de usuário.

interval_type
required
string

Período de atualização recorrente.

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

Tempo de atualização do limite no fuso horário desejado (arredondamento para horas).

object

Objeto com traduções para o nome do item. Código de idioma de duas letras minúsculas.

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

Prioridade da ordem de jogos na lista.

Array of objects or null

Período de venda de itens.

Array
date_from
string <date-time>

Data em que o item especificado estará disponível para venda.

date_until
string or null <date-time>

Data em que o item especificado ficará indisponível para venda. Pode ser null.

object

Configurações de pré-venda.

release_date
required
string

Data de lançamento da chave do jogo no formato ISO 8601.

is_enabled
required
boolean

Se desabilitado, o item não é uma pré-venda.

description
string

Informações adicionais para a pré-venda, que serão enviadas por 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 de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, pontos, traços e sublinhados.

Array of objects <= 20 items

Lista de atributos.

Atenção. Não é possível especificar mais de 20 atributos para o item. Qualquer tentativa de exceder o limite resulta em um erro.
Array (<= 20 items)
external_id
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

ID de atributo exclusivo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

required
Array of objects
Atenção. Não é possível criar mais de 6 valores para cada atributo. Qualquer tentativa de exceder o limite resulta em um erro.
Array
required
object
Default: {"de":"Strategie","en":"Strategy"}

Objeto com traduções do nome do valor. As chaves são especificadas no formato ISO 3166-1.

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

ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados.

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

Objeto com localizações para o nome do atributo. As chaves são especificadas no formato ISO 3166-1.

property name*
additional property
string
object

Objeto com localizações para descrição do item. Duas letras minúsculas código de idioma.

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

Grupo aos quais o item pertence.

Array
external_id
required
string
image_url
string

URL da imagem.

is_enabled
boolean

Se desabilitado, o item não poderá ser comprado nem acessado pelo inventário.

is_show_in_store
boolean

O item está disponível para compra.

object

Objeto com traduções para a descrição longa do item. Duas letras minúsculas código de idioma.

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

Recursos adicionais do jogo, como capturas de tela, vídeo de jogabilidade, etc.

Array
type
string

Tipo de mídia: image/video.

Enum: "image" "video"
url
string

Arquivo de recurso.

order
integer

Prioridade da ordem de jogos na lista.

Responses
201

Jogo criado com sucesso.

401

Autenticação básica não aprovada ou errada. Verifique se você usou a autenticação básica ou as credenciais corretas.

422

Solicitação inválida.

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"
}