Conjunto de atualização

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
sku required	string SKU de conjunto. Example: kg_1

Request Body schema: application/json

Objeto com dados de conjunto.

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

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 <= 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

Array of objects non-empty

Array (non-empty)

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.
quantity	integer >= 1 Default: 1 Quantidade dos itens selecionados no conjunto.

custom_attributes

object <json> <= 500 characters

Um objeto JSON que contém atributos e valores de item. Os atributos permitem que você adicione mais informações a itens como o nível necessário do jogador para usar o item. Os atributos enriquecem a lógica interna do seu jogo e são acessíveis através de métodos GET e webhooks dedicados.

groups

Array of strings

Default: []

Grupos aos quais o item pertence.

Observação: o valor da cadeia de caracteres refere-se ao grupo `external_id`.

image_url

string or null

URL da imagem.

is_enabled

boolean

Default: true

Se estiver desativado, o item não poderá ser encontrado nem comprado.

is_free

boolean

Default: false

Se true, o item é gratuito.

is_show_in_store

boolean

Default: false

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 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 or null

Ativos adicionais do conjunto.

Array

type	string Tipo de mídia: `image`/`video`. Enum: "image" "video"
url	string Arquivo de recurso.

order

integer

Default: 1

Prioridade de pedido do conjunto 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`.

Array of objects

Preços em moedas reais.

Array

amount required	string^\d\.?\d$ Preço do item.
currency required	string Moeda de compra. 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 um catálogo se nenhum preço na moeda do usuário for especificado.
is_enabled required	boolean O preço está habilitado.
country_iso	string or null País onde este preço está disponível. Código de duas letras de acordo com o padrão 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 de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos, pontos, traços e sublinhados.

Responses

204

Conjunto atualizado 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

{"attributes": {"attributes": [{"external_id": "class",
"name": {"en-US": "Class"
},
"values": [{"external_id": "soldier",
"value": {"en-US": "Soldier"
}
},
{"external_id": "officer",
"value": {"en-US": "Officer"
}
}
]
}
]
},
"content": [{"quantity": 1,
"sku": "iron_gloves"
},
{"quantity": 1,
"sku": "iron_boots"
},
{"quantity": 1,
"sku": "iron_shield"
},
{"quantity": 1,
"sku": "iron_armour"
},
{"quantity": 1,
"sku": "iron_helmet"
}
],
"custom_attributes": {"purchased": 0,
"type": "lootbox"
},
"description": {"de-DE": "Brustpanzer für Soldaten",
"en-US": "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-DE": "Brustpanzer für Soldaten",
"en-US": "Chest of armour for soldiers"
},
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"name": {"de-DE": "Brustpanzer",
"en-US": "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": "armour_chest",
"vc_prices": null
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}