Xsolla-logoXsolla Developers
ou
Vers le Compte éditeur

Mettre à jour partiellement les points de valeur des objetsServer-sideAdmin

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

Met à jour partiellement le nombre de points de valeur pour un ou plusieurs objets par UGS. Les utilisateurs reçoivent ces points de valeur après l'achat des objets spécifiés.

Principes de mise à jour des points de valeur :

  • Si un objet ne possède pas encore de points de valeur, l'envoi d'une valeur non nulle dans le champ amounten crée.
  • Si un objet possède déjà des points de valeur, l'envoi d'une valeur non nulle dans le champ amount les met à jour.
  • Si le champ amount est fixé à 0, les points de valeur existants pour cet objet sont supprimés.

Contrairement à la méthode PUT (Définir des points de valeur pour les objets), cette méthode PATCH n'écrase pas tous les points de valeur existants du projet, elle met uniquement à jour les objets spécifiés.

Une seule requête peut mettre à jour jusqu'à 100 objets. Les UGS en double ne sont pas autorisés dans la même requête.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.

Example: 44056
value_point_sku
required
string

UGS du point de valeur.

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

ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.

amount
required
integer >= 0

Montant des points de valeur.

Responses
204

Les récompenses en points de valeur des objets ont été mises à jour avec succès.

401

L'authentification de base n'a pas été passée ou est incorrecte. Vérifiez que vous avez utilisé l'authentification de base ou des informations d'identification correctes.

404

Objet non trouvé. Assurez-vous que les paramètres project_id et sku sont corrects.

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