Xsolla-logoXsolla Developers
또는
관리자 페이지로

아이템에 대한 가치 포인트를 부분적으로 업데이트Server-sideAdmin

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

아이템의 SKU에 의해 하나 이상의 아이템에 대한 가치 포인트 수를 부분적으로 업데이트합니다. 사용자는 지정된 아이템을 구매한 후 이러한 가치 포인트를 받게 됩니다.

가치 포인트 업데이트의 원칙:

  • 아이템에 아직 가치 포인트가 없는 경우 amount 필드에 0이 아닌 값을 보내면 가치 포인트가 생성됩니다.
  • 아이템에 이미 가치 포인트가 있는 경우 amount 필드에 0이 아닌 값을 보내면 가치 포인트가 업데이트됩니다.
  • amount를 0으로 설정하면 해당 아이템에 대한 기존 가치 포인트가 삭제됩니다.

PUT 메서드(아이템에 대한 가치 포인트 설정)와 달리 이 PATCH 메서드는 프로젝트의 아이템에 대한 모든 기존 가치 포인트를 덮어쓰지 않고 지정된 아이템만 업데이트합니다.

단일 요청으로 최대 100개의 아이템을 업데이트할 수 있습니다. 중복 아이템 SKU는 동일한 요청에 포함될 수 없습니다.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.

Example: 44056
value_point_sku
required
string

가치 포인트 SKU입니다.

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

고유 아이템 ID입니다. SKU는 소문자 및 대문자 라틴 영숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다.

amount
required
integer >= 0

가치 포인트의 금액입니다.

Responses
204

아이템에 대한 가치 포인트 보상이 성공적으로 업데이트되었습니다.

401

기본 인증이 전달되지 않았거나 잘못되었습니다. 기본 인증 또는 올바른 자격 증명을 사용했는지 확인해야 합니다.

404

아이템을 찾을 수 없습니다. project_idsku가 올바른지 확인해야 합니다.

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