리워드 체인 생성하기

리워드 체인 생성하기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

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>

리워드 체인이 시작되는 날짜입니다.

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 아이템 수량입니다.

image_url

string or null

이미지 URL입니다.

is_enabled

required

boolean

date_end

string or null <date-time>

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

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

리워드 체인을 성공적으로 생성했습니다.

401

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

422

잘못된 요청입니다.

Request samples

application/json

{"date_end": "2021-04-15T18:16:00+05:00",
"date_start": "2020-04-15T18:16:00+05:00",
"description": {"en": "Reward chain description"
},
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"is_enabled": true,
"long_description": {"en": "Reward chain long description"
},
"name": {"en": "Reward chain"
},
"order": 1,
"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": "item_sku_1"
},
{"quantity": 1,
"sku": "item_sku_2"
}
]
},
{"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": "item_sku_3"
},
{"quantity": 1,
"sku": "item_sku_4"
}
]
}
],
"value_point": {"sku": "value_point_sku"
}
}

Response samples

application/json

{"reward_chain_id": 10
}