Xsolla-logo

Definir pontos de valor para itens

put/v2/project/{project_id}/admin/items/{item_sku}/value_points/rewards

Atribui pontos de valor a um ou vários itens por um SKU. Os usuários recebem pontos de valor depois de comprar esses itens.

Observe que essa solicitação PUT substitui todos os pontos de valor definidos anteriormente para itens no projeto.

Para evitar a exclusão não intencional de pontos de valor, inclua todos os itens e seus respectivos pontos de valor em cada solicitação PUT.

Se desejar atualizar apenas os pontos de valor de um item específico, preservando os pontos de valor de outros itens, recupere o conjunto atual de pontos de valor usando uma solicitação GET, modifique os pontos de valor do item desejado e envie o conjunto modificado de pontos de valor de volta com os pontos de valor atualizados para o item específico.

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
item_sku
required
string

SKU do item.

Example: booster_mega_1
Request Body schema: application/json
Array
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.

amount
required
integer

Quantidade de pontos de valor.

Responses
204

As recompensas de pontos de valor para itens foram atualizadas 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.

404

Item não encontrado. Certifique-se de que o project_id e o sku estão corretos.

Request samples
application/json
[
  • {
    },
  • {
    }
]
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}