보상 체인 업데이트

Xsolla Developers

또는

관리자 페이지로

보상 체인 업데이트Server-sideAdmin

put/v2/project/{project_id}/admin/reward_chain/id/{reward_chain_id}

특정 보상 체인을 업데이트합니다.

SecuritybasicAuth

Request

path Parameters

project_id required	integer 프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다. Example: 44056
reward_chain_id required	integer 보상 체인 ID입니다. Example: 101

Request Body schema: application/json

One of:

보상 체인입니다.

required

(two-letter (object or null)) or (five-letter (object or null))

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 언어 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.

One of:

두 글자 소문자 언어 코드입니다.

ar	string or null 아랍어
bg	string or null 불가리아어
cn	string or null 중국어(간체)
cs	string or null 체코어
de	string or null 독일어
en	string or null 영어
es	string or null 스페인어(스페인)
fr	string or null 프랑스어
he	string or null 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	string or null 필리핀어
pl	string or null 폴란드어
pt	string or null 포르투칼어
ro	string or null 로마니아어
ru	string or null 러시아어
th	string or null 태국어
tr	string or null 터키어
tw	string or null 중국어(번체)
vi	string or null 베트남어

date_start

required

string <date-time>

보상 체인이 시작되는 날짜입니다.

required

Array of objects

Array

required

(two-letter (object or null)) or (five-letter (object or null))

One of:

두 글자 소문자 언어 코드입니다.

ar	string or null 아랍어
bg	string or null 불가리아어
cn	string or null 중국어(간체)
cs	string or null 체코어
de	string or null 독일어
en	string or null 영어
es	string or null 스페인어(스페인)
fr	string or null 프랑스어
he	string or null 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	string or null 필리핀어
pl	string or null 폴란드어
pt	string or null 포르투칼어
ro	string or null 로마니아어
ru	string or null 러시아어
th	string or null 태국어
tr	string or null 터키어
tw	string or null 중국어(번체)
vi	string or null 베트남어

required

object

amount

required

integer

가치 포인트의 단계 가격입니다.

required

Array of objects

Array

sku

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$

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

quantity

required

integer

아이템 수량입니다.

Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)

One of:

[ 1 .. 100 ] items

Array ([ 1 .. 100 ] items)

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

사용자 특성 코드입니다.

operator

required

string

조건에 따라 수행하는 작업 유형입니다. string 특성 유형에 해당합니다.

Enum:	Description
eq	같음
ne	같지 않음

value

required

string <= 255 characters

사용자 특성 값을 비교할 조건 값입니다. 유형은 특성 유형에 따라 다릅니다.

type

required

string

사용자 특성 유형입니다.

Value: "string"

can_be_missing

boolean

사용자 특성에서 특성이 누락된 경우에도 조건이 충족됨을 나타냅니다. 이 특성이 없는 사용자에게 항목을 표시하려면 true를 전달하십시오. 특성이 있지만 값이 조건에 지정된 값과 일치하지 않는 사용자는 항목을 볼 수 없습니다. false - 특성이 있지만 값이 조건에 지정된 값과 일치하지 않거나 특성이 누락된 사용자는 항목을 볼 수 없습니다.

step_id

required

integer or null

고유 단계 ID입니다.

image_url

string or null

이미지 URL입니다.

is_enabled

required

boolean

Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)

One of:

[ 1 .. 100 ] items

Array ([ 1 .. 100 ] items)

attribute

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

사용자 특성 코드입니다.

operator

required

string

조건에 따라 수행하는 작업 유형입니다. string 특성 유형에 해당합니다.

Enum:	Description
eq	같음
ne	같지 않음

value

required

string <= 255 characters

사용자 특성 값을 비교할 조건 값입니다. 유형은 특성 유형에 따라 다릅니다.

type

required

string

사용자 특성 유형입니다.

Value: "string"

can_be_missing

boolean

date_end

string or null <date-time>

보상 체인 프로모션이 종료되는 날짜입니다. null일 수 있습니다. date_end가 null이면 보상 체인이 시간 제한을 받지 않습니다.

(two-letter (object or null)) or (five-letter (object or null))

아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 다섯 글자 로케일 코드(예: en-US) 두 가지 형식 중 하나로 되어 있는 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 옵션(예: en 및 en-US)이 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.

One of:

두 글자 소문자 언어 코드입니다.

ar	string or null 아랍어
bg	string or null 불가리아어
cn	string or null 중국어(간체)
cs	string or null 체코어
de	string or null 독일어
en	string or null 영어
es	string or null 스페인어(스페인)
fr	string or null 프랑스어
he	string or null 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	string or null 필리핀어
pl	string or null 폴란드어
pt	string or null 포르투칼어
ro	string or null 로마니아어
ru	string or null 러시아어
th	string or null 태국어
tr	string or null 터키어
tw	string or null 중국어(번체)
vi	string or null 베트남어

image_url

string or null

이미지 URL입니다.

is_always_visible

boolean

Default: true

리워드 체인을 모든 사용자에게 표시할지 여부:

true인 경우, 사용자의 인증 상태나 특성에 관계없이 체인이 항상 표시됩니다.
false인 경우, 적절한 리워드 체인을 찾을 수 없는 경우에만 체인이 표시됩니다. 예를 들어, 사용자가 인증되지 않았거나 특성이 개인화된 체인과 일치하지 않는 경우에 그러합니다.

개인화된 리워드 체인의 컨텍스트에서만 적용되며 attribute_conditions 배열이 전달되지 않은 경우에 사용됩니다.

(two-letter (object or null)) or (five-letter (object or null))

아이템의 긴 설명에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: en) 또는 5자 로케일 코드(예 en-US: ) 두 가지 형식 중 하나로 값을 허용합니다. 두 형식 모두 입력으로 허용되지만 응답은 두 글자 소문자 언어 코드를 반환합니다. 동일한 언어에 대한 두 변수(예: en 및 en-US)가 모두 제공되면 마지막으로 제공된 값이 저장됩니다. 지원되는 언어의 전체 목록은 문서에서 확인할 수 있습니다.

Any of:

두 글자 소문자 언어 코드입니다.

ar	string or null 아랍어
bg	string or null 불가리아어
cn	string or null 중국어(간체)
cs	string or null 체코어
de	string or null 독일어
en	string or null 영어
es	string or null 스페인어(스페인)
fr	string or null 프랑스어
he	string or null 히브리어
id	string or null 인도네시아어
it	string or null 이탈리아어
ja	string or null 일본어
km	string or null 크메르어
ko	string or null 한국어
lo	string or null 라오스어
my	string or null 버마어
ne	string or null 네팔어
ph	string or null 필리핀어
pl	string or null 폴란드어
pt	string or null 포르투칼어
ro	string or null 로마니아어
ru	string or null 러시아어
th	string or null 태국어
tr	string or null 터키어
tw	string or null 중국어(번체)
vi	string or null 베트남어

order

integer

배열 순서를 정의합니다.

(interval_type = 주간 (object or null)) or (interval_type = 월간 (object or null))

보상 체인의 반복 재설정 기간입니다.

One of:

보상 체인의 주간 새로고침 유형입니다.

interval_type required	string 보상 체인의 반복 재설정 빈도입니다. Value: "weekly"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... 원하는 시간대에서 보상 체인이 재설정되는 시간입니다(시간 단위로 반올림). 예를 들어, 쿠알라룸푸르 시간대(GMT+8)의 경우 보상 체인 재설정 시간은 01:00입니다. 이 경우 `time` 매개 변수의 값은 `01:00:00+08:00`입니다.
day_of_week required	integer [ 1 .. 7 ] 보상 체인이 초기화되는 요일. 여기서 `1`은 월요일, `7`은 일요일입니다.

Responses

204

보상 체인을 성공적으로 업데이트했습니다.

401

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

404

보상 체인을 찾을 수 없습니다.

422

잘못된 요청입니다.

Request samples

application/json

{"clan_type": "guild",
"date_end": "2021-04-15T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"description": {"en": "Clan reward chain description."
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_enabled": true,
"long_description": {"en": "Clan reward chain long description."
},
"name": {"en": "Clan reward chain"
},
"order": 1,
"popup_header": {"en": "How to unlock rewards"
},
"popup_image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"popup_instruction": {"en": "You should be a clan member to get clan rewards. You join a clan when a clan member invited you to the clan, and you accepted the invite. You can create your own clan."
},
"recurrent_schedule": {"day_of_week": 1,
"interval_type": "weekly",
"time": "01:00:00+08:00"
},
"steps": [{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "First step of the reward chain"
},
"price": {"amount": 10
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_1"
},
{"quantity": 1,
"sku": "com.xsolla.item_2"
}
],
"step_id": 1
},
{"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"name": {"en": "Second step of the reward chain"
},
"price": {"amount": 15
},
"reward": [{"quantity": 5,
"sku": "com.xsolla.item_3"
},
{"quantity": 1,
"sku": "com.xsolla.item_4"
}
],
"step_id": 2
}
]
}

Response samples

application/json

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