Partially update value points for items

Partially updates the number of value points for one or more items by the item’s SKU. Users receive these value points after purchasing the specified items.

Principles of updating value points:

If an item does not yet have value points, sending a non-zero value in the amount field creates them.
If an item already has value points, sending a non-zero value in the amount field updates them.
If amount is set to 0, the existing value points for that item are deleted.

Unlike the PUT method (Set value points for items), this PATCH method does not overwrite all existing value points for items in the project, it only updates the specified items. A single request can update up to 100 items. Duplicate item SKUs cannot be included in the same request.

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 Value Point SKU. 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, pontos, traços e sublinhados.
amount required	integer >= 0 Quantidade de pontos de valor.

Responses

204

Value point rewards for items were successfully updated.

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

[{"amount": 100,
"sku": "booster_1"
},
{"amount": 0,
"sku": "booster_mega"
}
]

Response samples

application/json

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