혜택 체인 생성

아이템 이름에 대한 현지화가 있는 개체입니다. 두 글자 소문자 언어 코드(예: 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

step_number

required

integer >= 1

단계 번호입니다.

is_free

required

boolean

혜택 체인 단계가 무료인지 여부를 나타냅니다.

true인 경우 무료 혜택 체인 단계 신청 호출을 사용하여 해당 단계를 신청해야 합니다.
false인 경우 유료 혜택 체인 단계 주문 생성 호출을 사용하여 구매해야 합니다.

required

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ 고유 아이템 ID입니다. SKU는 소문자 및 대문자 라틴 영숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다.
quantity required	integer >= 1 이 체인 단계에 대한 리워드 아이템의 수량입니다.
order	integer or null >= 0 혜택 체인 단계에 대한 리워드 주문입니다.

is_enabled

required

boolean

Array of type = string (object) or type = number (object) or type = date (object) [ 1 .. 100 ] items

사용자 특성 검증 조건. 사용자 특성이 지정된 모든 조건과 일치하는지 여부에 따라 체인 가용성을 결정합니다.

Array ([ 1 .. 100 ] items)

One of:

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

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 베트남어

is_always_visible

boolean

Default: true

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

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

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

order

integer

배열 순서를 정의합니다.

(interval_type = weekly (object or null)) or (interval_type = monthly (object or null)) or (interval_type = hourly (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": null,
"date_start": "2023-04-15T18:16:00+05:00",
"description": {"de": "Eine kurze Beschreibung einer regulären Angebotskette",
"en": "A short description of a regular offer chain",
"fr": "Une brève description d'une chaîne d'offres régulière",
"it": "Una breve descrizione di una catena di offerte regolare",
"ru": "Краткое описание обычной цепочки предложений"
},
"is_always_visible": true,
"is_enabled": true,
"name": {"de": "Neue Angebotskette",
"en": "New offer chain",
"fr": "Nouvelle chaîne d'offres",
"it": "Nuova catena di offerte",
"ru": "Новая цепочка предложений"
},
"order": 4,
"recurrent_schedule": null,
"steps": [{"is_free": false,
"items": [{"quantity": 2,
"sku": "chain_step_1_paid_bundle_sku"
}
],
"step_number": 1
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "chain_step_2_free_virtual_good_sku"
}
],
"step_number": 2
},
{"is_free": false,
"items": [{"quantity": 5,
"sku": "chain_step_3_paid_virtual_currency_package_sku"
}
],
"step_number": 3
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "chain_step_4_free_bundle_sku"
}
],
"step_number": 4
}
]
}

Response samples

application/json

{"offer_chain_id": 10
}