> 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).
# 전시 레이아웃 구성안 관리
## 구성안 목록 조회
> \## 기능설명\
> \* 전시위치별 레이아웃 구성안 목록을 조회합니다.
```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":"사이트번호"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"layoutStatCd":{"type":"string","description":"레이아웃상태(DP041) 10 작업중/20 전시중/30 전시 안 함"},"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":"layoutStatCd","in":"query","description":"레이아웃상태(DP041) 10 작업중/20 전시중/30 전시 안 함","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 상태로 생성합니다.\
> \---\
> \## 상세설명\
> \* 구성안번호는 서버에서 채번(LCxxxxxxxxxx)하며, 생성된 구성안을 반환합니다.
```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. 생략 시 빈 문서."}}},"JsonNode":{},"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":"사이트번호"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"layoutStatCd":{"type":"string","description":"레이아웃상태(DP041) 10 작업중/20 전시중/30 전시 안 함"},"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":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 신규 생성","description":"## 기능설명\n* 전시위치(매장유형 + 위치키)에 대한 새 구성안을 DRAFT 상태로 생성합니다.\n---\n## 상세설명\n* 구성안번호는 서버에서 채번(LCxxxxxxxxxx)하며, 생성된 구성안을 반환합니다.\n","operationId":"createConfig","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveLayoutConfigRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePrDispLayoutConfig"}}}}}}}}}
```
## 구성안 목록 삭제
> \## 기능설명\
> \* 선택한 구성안들을 논리 삭제(USE\_YN='N')합니다.\
> \---\
> \## 상세설명\
> \* DRAFT(임시저장)·OFF(전시 안 함) 상태만 삭제 가능하며, LIVE(전시중)는 거부합니다.\
> \* 한 건이라도 삭제할 수 없으면 전체를 롤백합니다.\
> \* 필수 값 목록\
> \* 구성안번호 목록
```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* DRAFT(임시저장)·OFF(전시 안 함) 상태만 삭제 가능하며, LIVE(전시중)는 거부합니다.\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 를 조회합니다.
```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":"사이트번호"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"layoutStatCd":{"type":"string","description":"레이아웃상태(DP041) 10 작업중/20 전시중/30 전시 안 함"},"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 를 저장합니다.\
> \---\
> \## 상세설명\
> \* 리비전 낙관적락으로 갱신하며, 동시 수정으로 리비전이 어긋나면 오류를 반환합니다.
```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. 생략 시 빈 문서."}}},"JsonNode":{},"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":"사이트번호"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"layoutStatCd":{"type":"string","description":"레이아웃상태(DP041) 10 작업중/20 전시중/30 전시 안 함"},"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}":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 저장","description":"## 기능설명\n* 구성안의 기본정보와 LayoutDocument 를 저장합니다.\n---\n## 상세설명\n* 리비전 낙관적락으로 갱신하며, 동시 수정으로 리비전이 어긋나면 오류를 반환합니다.\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/ResponsePrDispLayoutConfig"}}}}}}}}}
```
## 구성안 게시(상태 전이)
> \## 기능설명\
> \* 구성안을 게시 방식에 따라 상태 전이합니다.\
> \---\
> \## 상세설명\
> \* now(즉시 게시): LIVE 로 전이하고 같은 전시대상의 기존 LIVE 레이아웃을 OFF 로 자동 종료합니다.\
> \* off(전시 안 함): OFF 로 전이합니다.\
> \* 동시 수정은 나중 저장이 이깁니다(낙관적락 없음).
```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":"사이트번호"},"layoutNo":{"type":"string","description":"레이아웃번호"},"layoutNm":{"type":"string","description":"레이아웃명"},"shopTypCd":{"type":"string","description":"매장유형코드(DP003)"},"dispTgtNo":{"type":"string","description":"전시대상번호(DP040/전시카테고리번호/브랜드번호)"},"dpmlNo":{"type":"string","description":"전시몰번호"},"layoutStatCd":{"type":"string","description":"레이아웃상태(DP041) 10 작업중/20 전시중/30 전시 안 함"},"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}/publish":{"post":{"tags":["전시 레이아웃 구성안 관리"],"summary":"구성안 게시(상태 전이)","description":"## 기능설명\n* 구성안을 게시 방식에 따라 상태 전이합니다.\n---\n## 상세설명\n* now(즉시 게시): LIVE 로 전이하고 같은 전시대상의 기존 LIVE 레이아웃을 OFF 로 자동 종료합니다.\n* off(전시 안 함): OFF 로 전이합니다.\n* 동시 수정은 나중 저장이 이깁니다(낙관적락 없음).\n","operationId":"publishConfig","parameters":[{"name":"layoutNo","in":"path","description":"구성안번호","required":true,"schema":{"type":"string"}},{"name":"mode","in":"query","description":"게시 방식(now/off)","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePrDispLayoutConfig"}}}}}}}}}
```
## 콘텐츠 이미지 업로드
> \## 기능설명\
> \* 전시 구성안 콘텐츠(배너/이미지) 이미지를 S3(display) 경로에 업로드하고 접근 URL 을 반환합니다.\
> \---\
> \## 상세설명\
> \* 여러 파일을 한 번에 업로드할 수 있으며, 빌더는 필드(PC/MO)당 1장씩 호출합니다.
```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":{}}}}}}}}}}
```
## 구성안 상품 요약 조회
> \## 기능설명\
> \* 상품번호 목록으로 상품명과 대표이미지를 한 번에 조회합니다.\
> \---\
> \## 상세설명\
> \* 구성안(layout\_json)은 상품번호만 저장합니다. 이름·이미지는 상품 쪽에서 바뀌므로\
> 구성안에 베껴 두지 않고 화면이 그릴 때 번호로 받아 갑니다.\
> \* 대표이미지가 없는 상품도 이름과 함께 내려갑니다.
```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":"상품명"},"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"}}}}}}}}}
```