Xsolla-logoXsolla Developers
ou
Conta de Distribuidor

Atualizar parcialmente os pontos de valor dos itensServer-sideAdmin

patch/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards

Atualiza parcialmente o número de pontos de valor para um ou mais itens pelo SKU do item. Os usuários recebem esses pontos de valor após a compra dos itens especificados.

Princípios de atualização de pontos de valor:

  • Se um item ainda não tiver pontos de valor, enviar um valor diferente de zero no campo amount os criará.
  • Se um item já tiver pontos de valor, o envio de um valor diferente de zero no campo amount os atualizará.
  • Se amount for definido como 0, os pontos de valor existentes para esse item serão excluídos.

Ao contrário do método PUT (Definir pontos de valor para itens), este método PATCH não sobrescreve todos os pontos de valor existentes dos itens no projeto, apenas atualiza os itens especificados.

Uma única solicitação pode atualizar até 100 itens. SKUs de itens duplicados não podem ser incluídos na mesma solicitação.

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

SKU de pontos de valor.

Example: value_point_3
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 e maiúsculos, pontos, traços e sublinhados.

amount
required
integer >= 0

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
}