Xsolla-logo
  • 문서화
  • 계정 생성

리워드 체인 생성하기Server-sideAdmin

post/v2/project/{project_id}/admin/reward_chain

리워드 체인을 생성합니다.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

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

Example: 44056
Request Body schema: application/json
One of:

보상 체인.

required
object

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자의 소문자 언어 코드입니다.

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
it
string or null
ja
string or null
ko
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
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

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

date_start
required
string <date-time>

Date when your reward chain starts.

required
Array of objects
Array
required
object

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자의 소문자 언어 코드입니다.

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
it
string or null
ja
string or null
ko
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 - 특성이 있지만 값이 조건에 지정된 값과 일치하지 않거나 속성이 누락된 사용자는 항목을 볼 수 없습니다.

image_url
string or null

이미지 URL입니다.

is_enabled
required
boolean
date_end
string or null <date-time>

리워드 체인 프로모션이 종료되는 날짜입니다. null일 수 있습니다. date_endnull이면 리워드 체인이 시간 제한을 받지 않습니다.

object

아이템 설명에 대한 현지화가 있는 개체입니다. 두 글자의 소문자 언어 코드입니다.

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
it
string or null
ja
string or null
ko
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입니다.

object

아이템에 대한 현지화된 긴 설명이 있는 개체입니다. 두 글자의 소문자 언어 코드입니다.

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
it
string or null
ja
string or null
ko
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
201

Reward chain was successfully created.

401

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

422

Invalid request.

Request samples
application/json
{}
Response samples
application/json
{
  • "reward_chain_id": 10
}