> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/display-bo-api/undefined-9.md).

# 전시 레이아웃 구성안 관리

## 구성안 목록 조회

> \## 기능설명\
> \* 전시위치별 레이아웃 구성안 목록을 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseRealGridListResponsePrDispLayoutConfig":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponsePrDispLayoutConfig","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponsePrDispLayoutConfig":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PrDispLayoutConfig"}}}},"PrDispLayoutConfig":{"type":"object","description":"전시 레이아웃 구성안","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutSysModDtm":{"type":"string","description":"동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"dispYn":{"type":"string","description":"전시여부"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispStatCd":{"type":"string","description":"화면 상태(조회 때 계산) 10 임시저장/20 전시/30 전시 안 함/40 전시 예약"},"layoutJson":{"type":"string","description":"레이아웃 JSON(구조 + 인라인 콘텐츠)"},"useYn":{"type":"string","description":"사용여부"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig":{"get":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 목록 조회","description":"## 기능설명\n* 전시위치별 레이아웃 구성안 목록을 조회합니다.\n","operationId":"getList","parameters":[{"name":"layoutNm","in":"query","description":"구성안명(부분검색)","schema":{"type":"string"}},{"name":"shopTypCd","in":"query","description":"전시매장유형(HOME/CATEGORY/BRAND/SLOT)","schema":{"type":"string"}},{"name":"dispTgtNo","in":"query","description":"전시위치키","schema":{"type":"string"}},{"name":"dispStatCd","in":"query","description":"화면 상태 10 임시저장/20 전시/30 전시 안 함/40 전시 예약","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"페이지 번호","schema":{"type":"number"}},{"name":"rowsPerPage","in":"query","description":"페이지당 개수","schema":{"type":"number"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponsePrDispLayoutConfig"}}}}}}}}}
```

## 구성안 신규 저장

> \## 기능설명\
> \* 새 구성안을 만들면서 동작(draft 임시저장 / now 즉시 전시 / reserve 전시 예약)까지 한 번에 처리합니다.\
> \---\
> \## 상세설명\
> \* 구성안번호는 서버에서 채번합니다. 동작이 막히면 400 이고 행이 생기지 않습니다.\
> \* dryRun=true 면 채번·저장 없이 결과(끝날 구성안·다음 시작·같은 위치 예약·막힌 이유)만 돌려줍니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SaveLayoutConfigRequest":{"type":"object","description":"전시 레이아웃 저장 요청","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"layoutDoc":{"$ref":"#/components/schemas/JsonNode","description":"레이아웃 문서(LayoutDocument) JSON. 생략 시 빈 문서."},"action":{"type":"string","description":"동작 draft 임시저장/save 변경 사항 저장/now 즉시 전시/reserve 전시 예약/off 전시 내리기/cancel 예약 취소"},"dispStrDtm":{"type":"string","description":"예약 일시(reserve). 오프셋이 없으면 KST 로 보고, 분 단위로 자른다"},"replaceLayoutNo":{"type":"string","description":"대체할 다음 예약 구성안 번호(replace). 같은 위치의 예약이어야 한다"},"dryRun":{"type":"boolean","description":"true 면 쓰지 않고 결과만 계산한다(모달 미리보기)"}}},"JsonNode":{},"ResponseLayoutSaveResult":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/LayoutSaveResult","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"LayoutSaveResult":{"type":"object","description":"전시 레이아웃 저장 결과","properties":{"config":{"$ref":"#/components/schemas/PrDispLayoutConfig","description":"처리한 구성안(미리보기면 없음)"},"canApply":{"type":"boolean","description":"처리할 수 있으면 true"},"blockReason":{"type":"string","description":"처리할 수 없는 이유"},"replaceOnly":{"type":"boolean","description":"true 면 이 위치의 전시는 그냥 내릴 수 없고 다음 예약으로 대체해야 한다(홈)"},"warning":{"type":"string","description":"처리는 되지만 알릴 것(콘텐츠 없는 코너 등)"},"dispStrDtmError":{"type":"string","description":"예약 일시 때문에 막힌 이유(없음·지난 시각·같은 일시). 일시 입력칸에 보여 준다"},"dispStrDtm":{"type":"string","format":"date-time","description":"이 구성안의 전시 시작일시(즉시 전시·예약)"},"ending":{"$ref":"#/components/schemas/LayoutScheduleEntry","description":"즉시 전시로 끝나는 구성안"},"next":{"$ref":"#/components/schemas/LayoutScheduleEntry","description":"다음에 시작하는 구성안(즉시 전시·예약: 이 구성안 다음, 전시 내리기: 다음 전시)"},"conflict":{"$ref":"#/components/schemas/LayoutScheduleEntry","description":"같은 일시라 예약을 막은 구성안"},"schedule":{"type":"array","description":"같은 위치의 예약(시작일 순, 이 구성안 포함)","items":{"$ref":"#/components/schemas/LayoutScheduleEntry"}}}},"PrDispLayoutConfig":{"type":"object","description":"전시 레이아웃 구성안","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutSysModDtm":{"type":"string","description":"동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"dispYn":{"type":"string","description":"전시여부"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispStatCd":{"type":"string","description":"화면 상태(조회 때 계산) 10 임시저장/20 전시/30 전시 안 함/40 전시 예약"},"layoutJson":{"type":"string","description":"레이아웃 JSON(구조 + 인라인 콘텐츠)"},"useYn":{"type":"string","description":"사용여부"}}},"LayoutScheduleEntry":{"type":"object","description":"전시 위치 일정","properties":{"layoutNo":{"type":"string","description":"레이아웃번호(새 구성안이면 없음)"},"layoutNm":{"type":"string","description":"레이아웃명"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시(반개구간)"},"self":{"type":"boolean","description":"요청한 구성안이면 true"},"conflict":{"type":"boolean","description":"같은 일시라 예약을 막은 상대면 true"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 신규 저장","description":"## 기능설명\n* 새 구성안을 만들면서 동작(draft 임시저장 / now 즉시 전시 / reserve 전시 예약)까지 한 번에 처리합니다.\n---\n## 상세설명\n* 구성안번호는 서버에서 채번합니다. 동작이 막히면 400 이고 행이 생기지 않습니다.\n* dryRun=true 면 채번·저장 없이 결과(끝날 구성안·다음 시작·같은 위치 예약·막힌 이유)만 돌려줍니다.\n","operationId":"createConfig","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveLayoutConfigRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseLayoutSaveResult"}}}}}}}}}
```

## 구성안 목록 삭제

> \## 기능설명\
> \* 선택한 구성안들을 논리 삭제(USE\_YN='N')합니다.\
> \---\
> \## 상세설명\
> \* 임시저장·전시 안 함만 삭제 가능하며, 전시·전시 예약은 거부합니다.\
> \* 한 건이라도 삭제할 수 없으면 전체를 롤백합니다.\
> \* 필수 값 목록\
> &#x20;   \* 구성안번호 목록<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseVoid":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig":{"delete":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 목록 삭제","description":"## 기능설명\n* 선택한 구성안들을 논리 삭제(USE_YN='N')합니다.\n---\n## 상세설명\n* 임시저장·전시 안 함만 삭제 가능하며, 전시·전시 예약은 거부합니다.\n* 한 건이라도 삭제할 수 없으면 전체를 롤백합니다.\n* 필수 값 목록\n    * 구성안번호 목록\n","operationId":"deleteConfigList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseVoid"}}}}}}}}}
```

## 구성안 상세 조회

> \## 기능설명\
> \* 구성안의 기본정보 + LayoutDocument 를 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponsePrDispLayoutConfig":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/PrDispLayoutConfig","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrDispLayoutConfig":{"type":"object","description":"전시 레이아웃 구성안","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutSysModDtm":{"type":"string","description":"동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"dispYn":{"type":"string","description":"전시여부"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispStatCd":{"type":"string","description":"화면 상태(조회 때 계산) 10 임시저장/20 전시/30 전시 안 함/40 전시 예약"},"layoutJson":{"type":"string","description":"레이아웃 JSON(구조 + 인라인 콘텐츠)"},"useYn":{"type":"string","description":"사용여부"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig/{layoutNo}":{"get":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 상세 조회","description":"## 기능설명\n* 구성안의 기본정보 + LayoutDocument 를 조회합니다.\n","operationId":"getDetail","parameters":[{"name":"layoutNo","in":"path","description":"구성안번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePrDispLayoutConfig"}}}}}}}}}
```

## 구성안 저장

> \## 기능설명\
> \* 기본정보·LayoutDocument 저장과 동작을 한 트랜잭션으로 처리합니다. 상태는 저장하지 않고 전시여부·시작일시만 바꿉니다(종료일시 없음).\
> \---\
> \## 상세설명\
> \* 위치마다 전시여부 Y 이고 이미 시작한 것 중 가장 늦게 시작한 1건이 전시 중입니다.\
> \* draft(임시저장)·save(변경 사항 저장): 내용만 저장합니다.\
> \* now(즉시 전시): 지금(초 단위)부터 전시. 떠 있던 구성안은 지난 전시가 됩니다.\
> \* reserve(전시 예약): dispStrDtm(분 단위, KST)부터 전시. 예약이면 일시를 바꿉니다. 같은 위치 같은 일시는 막습니다.\
> \* off(전시 내리기): 그 위치에서 이미 시작한 구성안을 모두 전시여부 N. 홈은 막힙니다(replace 나 새 구성안의 즉시 전시로만 바뀝니다).\
> \* replace(대체): 지금 전시는 전시 안 함, replaceLayoutNo(같은 위치 예약)를 지금 시작합니다.\
> \* cancel(예약 취소): 전시 안 함이 됩니다.\
> \* 기본정보·문서를 비우면 상태만 바꿉니다(같은 위치 다른 구성안의 예약 일시 변경·취소).\
> \* 어느 동작이든 저장 끝에 그 위치(위치를 옮겼으면 옛 위치도)의 지난 전시를 전시여부 N 으로 정리합니다.\
> \* dryRun=true 면 쓰지 않고 결과만 돌려줍니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SaveLayoutConfigRequest":{"type":"object","description":"전시 레이아웃 저장 요청","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"layoutDoc":{"$ref":"#/components/schemas/JsonNode","description":"레이아웃 문서(LayoutDocument) JSON. 생략 시 빈 문서."},"action":{"type":"string","description":"동작 draft 임시저장/save 변경 사항 저장/now 즉시 전시/reserve 전시 예약/off 전시 내리기/cancel 예약 취소"},"dispStrDtm":{"type":"string","description":"예약 일시(reserve). 오프셋이 없으면 KST 로 보고, 분 단위로 자른다"},"replaceLayoutNo":{"type":"string","description":"대체할 다음 예약 구성안 번호(replace). 같은 위치의 예약이어야 한다"},"dryRun":{"type":"boolean","description":"true 면 쓰지 않고 결과만 계산한다(모달 미리보기)"}}},"JsonNode":{},"ResponseLayoutSaveResult":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/LayoutSaveResult","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"LayoutSaveResult":{"type":"object","description":"전시 레이아웃 저장 결과","properties":{"config":{"$ref":"#/components/schemas/PrDispLayoutConfig","description":"처리한 구성안(미리보기면 없음)"},"canApply":{"type":"boolean","description":"처리할 수 있으면 true"},"blockReason":{"type":"string","description":"처리할 수 없는 이유"},"replaceOnly":{"type":"boolean","description":"true 면 이 위치의 전시는 그냥 내릴 수 없고 다음 예약으로 대체해야 한다(홈)"},"warning":{"type":"string","description":"처리는 되지만 알릴 것(콘텐츠 없는 코너 등)"},"dispStrDtmError":{"type":"string","description":"예약 일시 때문에 막힌 이유(없음·지난 시각·같은 일시). 일시 입력칸에 보여 준다"},"dispStrDtm":{"type":"string","format":"date-time","description":"이 구성안의 전시 시작일시(즉시 전시·예약)"},"ending":{"$ref":"#/components/schemas/LayoutScheduleEntry","description":"즉시 전시로 끝나는 구성안"},"next":{"$ref":"#/components/schemas/LayoutScheduleEntry","description":"다음에 시작하는 구성안(즉시 전시·예약: 이 구성안 다음, 전시 내리기: 다음 전시)"},"conflict":{"$ref":"#/components/schemas/LayoutScheduleEntry","description":"같은 일시라 예약을 막은 구성안"},"schedule":{"type":"array","description":"같은 위치의 예약(시작일 순, 이 구성안 포함)","items":{"$ref":"#/components/schemas/LayoutScheduleEntry"}}}},"PrDispLayoutConfig":{"type":"object","description":"전시 레이아웃 구성안","properties":{"siteNo":{"type":"string","description":"사이트번호"},"layoutSysModDtm":{"type":"string","description":"동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"dispYn":{"type":"string","description":"전시여부"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispStatCd":{"type":"string","description":"화면 상태(조회 때 계산) 10 임시저장/20 전시/30 전시 안 함/40 전시 예약"},"layoutJson":{"type":"string","description":"레이아웃 JSON(구조 + 인라인 콘텐츠)"},"useYn":{"type":"string","description":"사용여부"}}},"LayoutScheduleEntry":{"type":"object","description":"전시 위치 일정","properties":{"layoutNo":{"type":"string","description":"레이아웃번호(새 구성안이면 없음)"},"layoutNm":{"type":"string","description":"레이아웃명"},"dispStrDtm":{"type":"string","format":"date-time","description":"전시시작일시"},"dispEndDtm":{"type":"string","format":"date-time","description":"전시종료일시(반개구간)"},"self":{"type":"boolean","description":"요청한 구성안이면 true"},"conflict":{"type":"boolean","description":"같은 일시라 예약을 막은 상대면 true"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig/{layoutNo}":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 저장","description":"## 기능설명\n* 기본정보·LayoutDocument 저장과 동작을 한 트랜잭션으로 처리합니다. 상태는 저장하지 않고 전시여부·시작일시만 바꿉니다(종료일시 없음).\n---\n## 상세설명\n* 위치마다 전시여부 Y 이고 이미 시작한 것 중 가장 늦게 시작한 1건이 전시 중입니다.\n* draft(임시저장)·save(변경 사항 저장): 내용만 저장합니다.\n* now(즉시 전시): 지금(초 단위)부터 전시. 떠 있던 구성안은 지난 전시가 됩니다.\n* reserve(전시 예약): dispStrDtm(분 단위, KST)부터 전시. 예약이면 일시를 바꿉니다. 같은 위치 같은 일시는 막습니다.\n* off(전시 내리기): 그 위치에서 이미 시작한 구성안을 모두 전시여부 N. 홈은 막힙니다(replace 나 새 구성안의 즉시 전시로만 바뀝니다).\n* replace(대체): 지금 전시는 전시 안 함, replaceLayoutNo(같은 위치 예약)를 지금 시작합니다.\n* cancel(예약 취소): 전시 안 함이 됩니다.\n* 기본정보·문서를 비우면 상태만 바꿉니다(같은 위치 다른 구성안의 예약 일시 변경·취소).\n* 어느 동작이든 저장 끝에 그 위치(위치를 옮겼으면 옛 위치도)의 지난 전시를 전시여부 N 으로 정리합니다.\n* dryRun=true 면 쓰지 않고 결과만 돌려줍니다.\n","operationId":"saveConfig","parameters":[{"name":"layoutNo","in":"path","description":"구성안번호","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveLayoutConfigRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseLayoutSaveResult"}}}}}}}}}
```

## 콘텐츠 이미지 업로드

> \## 기능설명\
> \* 전시 구성안 콘텐츠(배너/이미지) 이미지를 S3(display) 경로에 업로드하고 접근 URL 을 반환합니다.\
> \---\
> \## 상세설명\
> \* 여러 파일을 한 번에 업로드할 수 있으며, 빌더는 필드(PC/MO)당 1장씩 호출합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListLayoutImageUploadResult":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/LayoutImageUploadResult"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"LayoutImageUploadResult":{"type":"object","description":"전시 구성안 이미지 업로드 결과","properties":{"fileNm":{"type":"string","description":"원본 파일명"},"filePath":{"type":"string","description":"업로드된 파일 경로(접근 URL)"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig/uploadImage":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"콘텐츠 이미지 업로드","description":"## 기능설명\n* 전시 구성안 콘텐츠(배너/이미지) 이미지를 S3(display) 경로에 업로드하고 접근 URL 을 반환합니다.\n---\n## 상세설명\n* 여러 파일을 한 번에 업로드할 수 있으며, 빌더는 필드(PC/MO)당 1장씩 호출합니다.\n","operationId":"uploadImage","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListLayoutImageUploadResult"}}}}}}}}}
```

## 전시 구성안 미리보기 세션 생성

> 편집 중인 레이아웃 문서로 미리보기 세션을 만든다(api-display 전달).

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v2/display/displayLayoutConfig/preview/":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"전시 구성안 미리보기 세션 생성","description":"편집 중인 레이아웃 문서로 미리보기 세션을 만든다(api-display 전달).","operationId":"createPreview","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{}}}}}}}}}}
```

## 전시 구성안 미리보기 세션 생성

> 편집 중인 레이아웃 문서로 미리보기 세션을 만든다(api-display 전달).

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}}},"paths":{"/v2/display/displayLayoutConfig/preview":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"전시 구성안 미리보기 세션 생성","description":"편집 중인 레이아웃 문서로 미리보기 세션을 만든다(api-display 전달).","operationId":"createPreview_1","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{}}}}}}}}}}
```

## 구성안 기획전 요약 조회

> \## 기능설명\
> \* 기획전번호 목록으로 기획전명과 대표이미지를 한 번에 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품 요약(goodsSummaries)과 같은 이유로 구성안에는 기획전번호만 저장합니다.\
> \* 대표이미지는 FO 기획전 목록 카드와 같은 기준(정사각 우선)으로 고르고, 없으면 비어 있습니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListLayoutPlanSummary":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/LayoutPlanSummary"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"LayoutPlanSummary":{"type":"object","description":"구성안 기획전 표시용 요약","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"repImgPathNm":{"type":"string","description":"대표이미지 경로(CDN 상대경로). 이미지가 없으면 비어 있다."}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig/planSummaries/":{"get":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 기획전 요약 조회","description":"## 기능설명\n* 기획전번호 목록으로 기획전명과 대표이미지를 한 번에 조회합니다.\n---\n## 상세설명\n* 상품 요약(goodsSummaries)과 같은 이유로 구성안에는 기획전번호만 저장합니다.\n* 대표이미지는 FO 기획전 목록 카드와 같은 기준(정사각 우선)으로 고르고, 없으면 비어 있습니다.\n","operationId":"getPlanSummaries","parameters":[{"name":"mkdpNoList","in":"query","description":"기획전번호 목록","required":true,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListLayoutPlanSummary"}}}}}}}}}
```

## 구성안 기획전 요약 조회

> \## 기능설명\
> \* 기획전번호 목록으로 기획전명과 대표이미지를 한 번에 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품 요약(goodsSummaries)과 같은 이유로 구성안에는 기획전번호만 저장합니다.\
> \* 대표이미지는 FO 기획전 목록 카드와 같은 기준(정사각 우선)으로 고르고, 없으면 비어 있습니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListLayoutPlanSummary":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/LayoutPlanSummary"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"LayoutPlanSummary":{"type":"object","description":"구성안 기획전 표시용 요약","properties":{"mkdpNo":{"type":"string","description":"기획전번호"},"mkdpNm":{"type":"string","description":"기획전명"},"repImgPathNm":{"type":"string","description":"대표이미지 경로(CDN 상대경로). 이미지가 없으면 비어 있다."}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig/planSummaries":{"get":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 기획전 요약 조회","description":"## 기능설명\n* 기획전번호 목록으로 기획전명과 대표이미지를 한 번에 조회합니다.\n---\n## 상세설명\n* 상품 요약(goodsSummaries)과 같은 이유로 구성안에는 기획전번호만 저장합니다.\n* 대표이미지는 FO 기획전 목록 카드와 같은 기준(정사각 우선)으로 고르고, 없으면 비어 있습니다.\n","operationId":"getPlanSummaries_1","parameters":[{"name":"mkdpNoList","in":"query","description":"기획전번호 목록","required":true,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListLayoutPlanSummary"}}}}}}}}}
```

## 구성안 상품 요약 조회

> \## 기능설명\
> \* 상품번호 목록으로 상품명과 대표이미지를 한 번에 조회합니다.\
> \---\
> \## 상세설명\
> \* 구성안(layout\_json)은 상품번호만 저장합니다. 이름·이미지는 상품 쪽에서 바뀌므로\
> &#x20; 구성안에 베껴 두지 않고 화면이 그릴 때 번호로 받아 갑니다.\
> \* 대표이미지가 없는 상품도 이름과 함께 내려갑니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListLayoutGoodsSummary":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/LayoutGoodsSummary"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"LayoutGoodsSummary":{"type":"object","description":"구성안 상품 표시용 요약","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명. 요청 언어 상품명이 없으면 기본 언어(ko) 상품명이고, 둘 다 없으면 비어 있다."},"repImgPathNm":{"type":"string","description":"대표이미지 경로(CDN 상대경로). 이미지가 없으면 비어 있다."}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/display/displayLayoutConfig/goodsSummaries":{"get":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 상품 요약 조회","description":"## 기능설명\n* 상품번호 목록으로 상품명과 대표이미지를 한 번에 조회합니다.\n---\n## 상세설명\n* 구성안(layout_json)은 상품번호만 저장합니다. 이름·이미지는 상품 쪽에서 바뀌므로\n  구성안에 베껴 두지 않고 화면이 그릴 때 번호로 받아 갑니다.\n* 대표이미지가 없는 상품도 이름과 함께 내려갑니다.\n","operationId":"getGoodsSummaries","parameters":[{"name":"goodsNoList","in":"query","description":"상품번호 목록","required":true,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListLayoutGoodsSummary"}}}}}}}}}
```
