혜택 체인 업데이트

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

Request Body schema: application/json

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

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 혜택 체인 단계에 대한 리워드 주문입니다.

step_id

integer or null >= 1

고유한 체인 단계 ID입니다. 이 단계에 대한 사용자 진행 상황을 유지하려면 업데이트 중에 지정합니다.

is_enabled

required

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

integer

고유한 혜택 체인 ID입니다.

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

{"date_end": null,
"date_start": "2023-04-15T18:16:00+05:00",
"description": {"en": "Updated offer chain description"
},
"is_enabled": true,
"name": {"en": "Updated offer chain",
"ru": "Обновленная цепочка товаров"
},
"order": 4,
"steps": [{"is_free": false,
"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_1"
}
],
"step_number": 1
},
{"is_free": false,
"items": [{"quantity": 1,
"sku": "vg_enabled_shown_in_store_2"
}
],
"step_number": 2
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "vg_not_shown_in_store"
}
],
"step_id": 10,
"step_number": 3
},
{"is_free": false,
"items": [{"quantity": 1,
"sku": "bundle_enabled_shown_in_store_with_2_enabled_shown_in_store_vg"
}
],
"step_id": 8,
"step_number": 4
},
{"is_free": true,
"items": [{"quantity": 1,
"sku": "vcp_enabled_shown_in_store_1_of_10_vc_enabled_shown_in_store_1"
}
],
"step_number": 5
}
]
}

Response samples

application/json

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