Xsolla-logoXsolla Developers
o
A Cuenta del editor

Actualizar parcialmente los puntos de valor para los artículosServer-sideAdmin

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

Actualiza parcialmente la cantidad de puntos de valor de uno o más artículos según el SKU del artículo. Los usuarios reciben estos puntos de valor después de comprar los artículos especificados.

Principios de actualización de los puntos de valor:

  • Si un artículo aún no tiene puntos de valor, el envío de un valor distinto de cero en el campo amount los genera.
  • Si un artículo ya tiene puntos de valor, enviar un valor distinto de cero en el campo amount los actualiza.
  • Si amount se establece en 0, se eliminan los puntos de valor existentes para ese artículo.

A diferencia del método PUT (Establecer puntos de valor para artículos), este método PATCH no sobrescribe todos los puntos de valor existentes para los artículos del proyecto, solo actualiza los artículos especificados.

Una sola solicitud puede actualizar hasta 100 artículos. No se pueden incluir SKU de artículos duplicados en la misma solicitud.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.

Example: 44056
value_point_sku
required
string

Código de artículo (SKU) del punto de valor.

Example: value_point_3
Request Body schema: application/json
Array
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

ID único del artículo. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.

amount
required
integer >= 0

Cantidad de puntos de valor.

Responses
204

Se actualizaron correctamente las recompensas de puntos de valor para los artículos.

401

Autenticación básica no superada o errónea. Asegúrese de haber utilizado la autenticación básica o las credenciales correctas.

404

Artículo no encontrado. Asegúrese de que el project_id y el sku sean correctos.

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