기획전 정보 관리
기능설명
기획전 등록/수정 팝업_구분자 탭을 등록/수정/삭제 API 입니다.
상세설명
구분자 유형으로 텍스트, 배너, HTML 등록 할 수 있으며 필수로 입력해야 합니다.
구분자명은 구분자 상품 리스트에서 상품을 구분짓는 구분자 명으로 사용됩니다.
입력 파라미터( * : 필수)
create : divobjNm *, divobjGbCd *, tmplNo *, dispYn *, dispSeq *, dispMediaCd *, langCd *, bnrImgPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, textDivobjNm ,stateForm *
update : divobjNo *, divobjNm *, divobjGbCd *, tmplNo *, dispYn *, dispSeq *, dispMediaCd *, langCd *, bnrImgPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, textDivobjNm ,stateForm *
delete : mkdpNo *, divobjNo *
기획전 구분자탭 저장 성공
result time
result code
result message
process check
payload
is error
기획전 구분자탭 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/savePrMkdpDivobj HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 885
{
"files": [
"binary"
],
"prMkdpDivobjInfoList": [
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"dispMediaCd": 99,
"divobjGbCd": 10,
"divobjNm": "구분자명",
"dispYn": "Y",
"dispSeq": 1,
"tmplNo": 10020,
"cpnNo": "C1001442",
"textDivobjNm": "텍스트구분자명",
"bnrImgPathNm": "/이미지경로명",
"bnrImgFileNm": "이미지파일명",
"cpnBnrImgPathNm": "/쿠폰이미지경로명",
"bnrImgAltCont": "쿠폰이미지대체텍스트",
"cpnBnrImgFileNm": "쿠폰이미지파일명",
"htmlFileCont": "HTML내용",
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"stateForm": "I"
}
]
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": "text",
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기능설명
기획전 구분자 다국어 정보를 저장하는 API 입니다.
상세설명
구분자 기본정보 유형에 따라 다국어 정보를 입력할 수 있습니다. (HTML -> HTML, 배너 -> 배너, 텍스트 -> 텍스트)
구분자 다국어명은 구분자 상품 리스트에서 상품을 구분짓는 구분자 다국어 명으로 사용됩니다.
입력 파라미터( * : 필수)
update : mkdpNo *, divobjNo *, divobjNm *, txtDivobjNm, bnrImagPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, langCd *
기획전 구분자정보 다국어 저장 성공
result time
result code
result message
process check
payload
is error
기획전 구분자정보 다국어 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/savePrMkdpDivobjMl HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 879
{
"files": [
"binary"
],
"prMkdpDivobjInfo": {
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"dispMediaCd": 99,
"divobjGbCd": 10,
"divobjNm": "구분자명",
"dispYn": "Y",
"dispSeq": 1,
"tmplNo": 10020,
"cpnNo": "C1001442",
"textDivobjNm": "텍스트구분자명",
"bnrImgPathNm": "/이미지경로명",
"bnrImgFileNm": "이미지파일명",
"cpnBnrImgPathNm": "/쿠폰이미지경로명",
"bnrImgAltCont": "쿠폰이미지대체텍스트",
"cpnBnrImgFileNm": "쿠폰이미지파일명",
"htmlFileCont": "HTML내용",
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"stateForm": "I"
}
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": "text",
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기능설명
기획전 등록/수정 팝업_기본정보 탭을 등록 및 수정하는 API 입니다.
상세설명
사이트, 사이트기준 몰, 몰기준 그룹을 선택 할 수 있습니다.
리스트 콘텐츠1, 리스트 콘텐츠2는 필수값입니다. 또한 전시매체 PC, MO 하나씩 등록하거나 공통을 등록 할 수 있습니다.
회원 등급 및 임직원 여부에 따라 FO 노출이 제한됩니다.
입력 파라미터( * : 필수)
create : mkdpNm *, siteNo *, dpmlNo *, tmplNo *, dispYn *, dispSeq *, dispStrDtm *, dispEndDtm *, mdId *, mkdpTtlHtml, mkdpTtlHtmlPc , htmlContYn, kwdNm, brefDsec, introConts, fotrFileConts, aplyBrand, pcTtopExpYn, langCd *, dispMediaCd *, dispStafYn, mbrDispGradCd
update : mkdpNo *, mkdpNm *, siteNo *, dpmlNo *, tmplNo *, dispYn *, dispSeq *, dispStrDtm *, dispEndDtm *, mdId *, mkdpTtlHtml, mkdpTtlHtmlPc , htmlContYn, kwdNm, brefDsec,introConts,fotrFileConts, aplyBrand, pcTtopExpYn, langCd *, dispMediaCd *, dispStafYn, mbrDispGradCd
기획전 기본정보 탭 등록/수정 성공
result time
result code
result message
process check
is error
기획전 기본정보 탭 등록/수정 실패
POST /api/bo/v1/display/marketingDisplayMgmt/savePrMkdpBase HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1590
{
"files": [
"binary"
],
"prMkdpBase": {
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": {
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
},
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기능설명
기획전 구성안 목록 그리드에서 고친 전시여부·전시순서만 저장하는 API 입니다.
상세설명
기획전 관리 목록의 저장(
saveMarketingDisplayMgmtList)과 경로를 나눕니다 — 그 쪽은 전시기간까지 함께 덮으므로, 목록을 조회한 뒤 다른 운영자가 편집기에서 기간을 바꾸면 먼저 조회한 목록에서 순서만 저장해도 그 기간이 옛 값으로 되돌아갑니다.전시순서는 필수이며 1 이상입니다. 같은 순서가 여럿인 것은 막지 않습니다.
수정자는 받지 않고 로그인 사용자로 채웁니다.
삭제 목록이 없습니다 — 기획전 삭제는 기획전 정보 관리가 맡습니다.
저장 후 해당 기획전들의 FO 캐시를 무효화합니다.
기획전 구성안 목록 전시여부·전시순서 저장 요청
저장 성공
result time
result code
result message
process check
payload
is error
저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/savePlanLayoutDispList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 54
{
"update": [
{
"mkdpNo": 14862,
"dispYn": "Y",
"dispSeq": 1
}
]
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": null,
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기획전 구성안 저장 요청
기획전번호
14862레이아웃 문서(LayoutDocument)
문서를 읽어 간 시각(동시 저장 검사용)
기획전 구성안 저장 성공
기획전 구성안
사이트번호
동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)
레이아웃번호
레이아웃명
매장유형코드(DP003)
전시대상번호(기획전번호)
전시몰번호
전시여부
전시시작일시
레이아웃 JSON
사용여부
기획전 구성안 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/savePlanLayoutConfig HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 58
{
"mkdpNo": 14862,
"layoutDoc": null,
"layoutSysModDtm": "text"
}{
"siteNo": "text",
"layoutSysModDtm": "text",
"layoutNo": "text",
"layoutNm": "text",
"shopTypCd": "text",
"dispTgtNo": "text",
"dpmlNo": "text",
"dispYn": "text",
"dispStrDtm": "2026-01-01T00:00:00.000Z",
"layoutJson": "text",
"useYn": "text"
}기획전 편집기 저장 성공
기획전기본
사이트번호
1언어코드
ko기획전번호
14862기획전명
기획전 제목사이트명
플래티어닷컴몰번호
10001템플릿번호
10020전시여부
Y전시순서
1전시시작일시
2023-01-01 00:00:00.000전시종료일시
2023-12-31 00:00:00.000담당MD
tester기획전타이틀HTML_MO
HTML_MO기획전타이틀HTML_PC
HTML_PCHTML컨텐츠여부
N키워드명
키워드명간략설명
간략설명소개글
소개글푸터파일내용
푸터파일내용기획전브랜드리스트
[100001,100002]PC상단노출여부
Y전시그룹번호
132전시매체코드
20임직원여부
Y템플릿파일명
MarketingTemplate1전시회원코드 배열
[30,40]배너이미지경로명
배너이미지대체텍스트
전체개수
업로드파일 순번
기획전 편집기 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/savePlanEditor HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1695
{
"files": [
"binary"
],
"request": {
"basics": {
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
},
"layoutDoc": null,
"layoutSysModDtm": "text",
"basicsMl": [
{
"mkdpNo": 14862,
"dispYn": "Y",
"dispSeq": 1
}
]
}
}{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}기획전상품정보
언어코드
ko기획전번호
14862구분자번호
1상품번호
10002131상품명
상품명전시순서
1판매상태코드
10판매상태코드명
판매중협력사번호
1000002협력사명
플래티어 협력사정상가
25000할인가
20000오류메시지
해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.오류상태
타임딜적용여부
타임딜시작일시
타임딜종료일시
타임딜판매가
기획전 상품 엑셀 일괄 저장 성공
기획전상품정보
언어코드
ko기획전번호
14862구분자번호
1상품번호
10002131상품명
상품명전시순서
1판매상태코드
10판매상태코드명
판매중협력사번호
1000002협력사명
플래티어 협력사정상가
25000할인가
20000오류메시지
해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.오류상태
타임딜적용여부
타임딜시작일시
타임딜종료일시
타임딜판매가
기획전 상품 엑셀 일괄 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/saveMarketingMgmtExcelGoodsList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 472
[
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
]{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}기획전 목록 저장 성공
result time
result code
result message
process check
payload
is error
기획전 목록 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 6270
{
"all": [
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}
],
"create": [
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}
],
"update": [
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}
],
"delete": [
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}
]
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": "text",
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기획전 기본정보 다국어 저장 성공
result time
result code
result message
process check
is error
기획전 기본정보 다국어 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtBaseMl HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1590
{
"files": [
"binary"
],
"prMkdpBase": {
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": {
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
},
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기획전 상품 정보 저장 성공
result time
result code
result message
process check
payload
is error
기획전 상품 정보 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/saveDivobjGoodsGridList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1926
{
"all": [
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
],
"create": [
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
],
"update": [
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
],
"delete": [
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
]
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": "text",
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기획전상품정보
언어코드
ko기획전번호
14862구분자번호
1상품번호
10002131상품명
상품명전시순서
1판매상태코드
10판매상태코드명
판매중협력사번호
1000002협력사명
플래티어 협력사정상가
25000할인가
20000오류메시지
해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.오류상태
타임딜적용여부
타임딜시작일시
타임딜종료일시
타임딜판매가
기획전 상품 엑셀 일괄 저장 성공
기획전상품정보
언어코드
ko기획전번호
14862구분자번호
1상품번호
10002131상품명
상품명전시순서
1판매상태코드
10판매상태코드명
판매중협력사번호
1000002협력사명
플래티어 협력사정상가
25000할인가
20000오류메시지
해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.오류상태
타임딜적용여부
타임딜시작일시
타임딜종료일시
타임딜판매가
기획전 상품 엑셀 일괄 저장 실패
POST /api/bo/v1/display/marketingDisplayMgmt/saveBulkDivobjGoodsUpload HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 472
[
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
]{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}기획전기본
사이트번호
1언어코드
ko기획전번호
14862기획전명
기획전 제목사이트명
플래티어닷컴몰번호
10001템플릿번호
10020전시여부
Y전시순서
1전시시작일시
2023-01-01 00:00:00.000전시종료일시
2023-12-31 00:00:00.000담당MD
tester기획전타이틀HTML_MO
HTML_MO기획전타이틀HTML_PC
HTML_PCHTML컨텐츠여부
N키워드명
키워드명간략설명
간략설명소개글
소개글푸터파일내용
푸터파일내용기획전브랜드리스트
[100001,100002]PC상단노출여부
Y전시그룹번호
132전시매체코드
20임직원여부
Y템플릿파일명
MarketingTemplate1전시회원코드 배열
[30,40]배너이미지경로명
배너이미지대체텍스트
전체개수
업로드파일 순번
기획전 복사 성공
result time
result code
result message
process check
payload
is error
기획전 복사 실패
POST /api/bo/v1/display/marketingDisplayMgmt/registerCopyMarketingDisplayMgmt HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1556
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": "text",
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기획전번호
14862구분자번호
1상품정보리스트
기획전상품정보 Search 모델
기획전번호
구분자번호
상품번호
전시순서
상품번호 배열
OK
result time
result code
result message
process check
is error
POST /api/bo/v1/display/marketingDisplayMgmt/getValidPlanShopGoodsList?mkdpNo=text&divobjNo=text&goodsInfoList=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 575
{
"mkdpNo": "text",
"divobjNo": "text",
"goodsNo": "text",
"dispSeq": 1,
"goodsArray": [
"text"
],
"goodsInfoList": [
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
]
}OK
{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": [
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}
],
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}상품번호 목록
10001741,10001791OK
result time
result code
result message
process check
is error
GET /api/bo/v1/display/marketingDisplayMgmt/planGoodsUnits?goodsNoList=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
OK
{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": [
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
],
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}기획전번호
14862구분자번호
1언어코드
en기획전 구분자 다국어정보 조회 성공
기획전 구분자 정보
언어코드
ko기획전번호
14862구분자번호
1전시매체코드(DP018)
99구분자구분코드(DP024)
10구분자명
구분자명전시여부
Y전시순서
1템플릿번호
10020쿠폰번호
C1001442텍스트구분자명
텍스트구분자명배너이미지경로명
/이미지경로명배너이미지파일명
이미지파일명쿠폰배너이미지경로명
/쿠폰이미지경로명쿠폰배너이미지대체텍스트
쿠폰이미지대체텍스트쿠폰배너이미지파일명
쿠폰이미지파일명HTML파일내용
HTML내용구분자상태
I기획전 구분자 다국어정보 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getPrMkdpDivobjMultiLanguage?mkdpNo=text&divobjNo=text&langCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"dispMediaCd": 99,
"divobjGbCd": 10,
"divobjNm": "구분자명",
"dispYn": "Y",
"dispSeq": 1,
"tmplNo": 10020,
"cpnNo": "C1001442",
"textDivobjNm": "텍스트구분자명",
"bnrImgPathNm": "/이미지경로명",
"bnrImgFileNm": "이미지파일명",
"cpnBnrImgPathNm": "/쿠폰이미지경로명",
"bnrImgAltCont": "쿠폰이미지대체텍스트",
"cpnBnrImgFileNm": "쿠폰이미지파일명",
"htmlFileCont": "HTML내용",
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"stateForm": "I"
}기획전번호
14862언어코드
en기획전 기본정보 다국어 조회 성공
기획전기본
사이트번호
1언어코드
ko기획전번호
14862기획전명
기획전 제목사이트명
플래티어닷컴몰번호
10001템플릿번호
10020전시여부
Y전시순서
1전시시작일시
2023-01-01 00:00:00.000전시종료일시
2023-12-31 00:00:00.000담당MD
tester기획전타이틀HTML_MO
HTML_MO기획전타이틀HTML_PC
HTML_PCHTML컨텐츠여부
N키워드명
키워드명간략설명
간략설명소개글
소개글푸터파일내용
푸터파일내용기획전브랜드리스트
[100001,100002]PC상단노출여부
Y전시그룹번호
132전시매체코드
20임직원여부
Y템플릿파일명
MarketingTemplate1전시회원코드 배열
[30,40]배너이미지경로명
배너이미지대체텍스트
전체개수
업로드파일 순번
기획전 기본정보 다국어 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getPrMkdpBaseMultiLanguage?mkdpNo=text&langCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}기획전번호
14862기획전명
성능테스트 기획전담당MD
전시매체코드(DP018)
99사용자아이디
전시여부
Y브랜드명
전시시작날짜
20230101전시종료날짜
20991231기획전상태
20사이트번호
1몰번호
10001전시그룹번호
132페이지 당 row
100현재 페이지
1기획전 정보 조회 성공
기획전기본
사이트번호
1언어코드
ko기획전번호
14862기획전명
기획전 제목사이트명
플래티어닷컴몰번호
10001템플릿번호
10020전시여부
Y전시순서
1전시시작일시
2023-01-01 00:00:00.000전시종료일시
2023-12-31 00:00:00.000담당MD
tester기획전타이틀HTML_MO
HTML_MO기획전타이틀HTML_PC
HTML_PCHTML컨텐츠여부
N키워드명
키워드명간략설명
간략설명소개글
소개글푸터파일내용
푸터파일내용기획전브랜드리스트
[100001,100002]PC상단노출여부
Y전시그룹번호
132전시매체코드
20임직원여부
Y템플릿파일명
MarketingTemplate1전시회원코드 배열
[30,40]배너이미지경로명
배너이미지대체텍스트
전체개수
업로드파일 순번
기획전 정보 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getPrMkdpBaseList?rowsPerPage=text&pageIdx=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}기획전번호
14862언어코드
ko기획전 상세정보 조회 성공
기획전기본
사이트번호
1언어코드
ko기획전번호
14862기획전명
기획전 제목사이트명
플래티어닷컴몰번호
10001템플릿번호
10020전시여부
Y전시순서
1전시시작일시
2023-01-01 00:00:00.000전시종료일시
2023-12-31 00:00:00.000담당MD
tester기획전타이틀HTML_MO
HTML_MO기획전타이틀HTML_PC
HTML_PCHTML컨텐츠여부
N키워드명
키워드명간략설명
간략설명소개글
소개글푸터파일내용
푸터파일내용기획전브랜드리스트
[100001,100002]PC상단노출여부
Y전시그룹번호
132전시매체코드
20임직원여부
Y템플릿파일명
MarketingTemplate1전시회원코드 배열
[30,40]배너이미지경로명
배너이미지대체텍스트
전체개수
업로드파일 순번
기획전 상세정보 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getPrMkdpBaseDetail?mkdpNo=text&langCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"siteNo": 1,
"langCd": "ko",
"mkdpNo": 14862,
"mkdpNm": "기획전 제목",
"siteNm": "플래티어닷컴",
"dpmlNo": 10001,
"tmplNo": 10020,
"dispYn": "Y",
"dispSeq": 1,
"dispStrDtm": "2023-01-01 00:00:00.000",
"dispEndDtm": "2023-12-31 00:00:00.000",
"mdId": "tester",
"mkdpTtlHtml": "HTML_MO",
"mkdpTtlHtmlPc": "HTML_PC",
"htmlContYn": "N",
"kwdNm": "키워드명",
"brefDesc": "간략설명",
"introConts": "소개글",
"fotrFileConts": "푸터파일내용",
"brandInfoMap": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"aplyBrand": [
100001,
100002
],
"pcTtopExpYn": "Y",
"dispGrpNo": 132,
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"deleteList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"dispMediaCd": 20,
"dispStafYn": "Y",
"tmplFileNm": "MarketingTemplate1",
"dispGrpNoList": [
"text"
],
"mbrDispGradeCd": [
30,
40
],
"bnrImgPathNm": "text",
"bnrImgAltCont": "text",
"totalCount": 1,
"fileIdx": 1,
"dispStat": "text",
"dispStatName": "text",
"dispMediaNm": "text"
}기획전번호
14862언어코드
ko기획전 상세 이미지 조회 성공
전시이미지정보
언어코드
ko전시매장구분코드(DP009)
01매장카테고리번호
132이미지유형코드(DP013)
01이미지일련번호
133배너이미지경로명
/배너이미지경로배너이미지파일명
배너이미지파일명배너이미지 대체텍스트
배너이미지 대체텍스트연결URL주소
/연결URL주소전시매체코드(DP018)
99기획전상태
10썸네일이미지경로
/썸네일이미지경로콘텐츠구분코드(SN007)
매장카테코리번호(복사)
이미지업로드 순번
기획전 상세 이미지 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getPrDispImgInfoDetail?mkdpNo=text&langCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}기획전번호
14862기획전 구성안 조회 성공
기획전 구성안
사이트번호
동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)
레이아웃번호
레이아웃명
매장유형코드(DP003)
전시대상번호(기획전번호)
전시몰번호
전시여부
전시시작일시
레이아웃 JSON
사용여부
기획전 구성안 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getPlanLayoutConfig?mkdpNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"siteNo": "text",
"layoutSysModDtm": "text",
"layoutNo": "text",
"layoutNm": "text",
"shopTypCd": "text",
"dispTgtNo": "text",
"dpmlNo": "text",
"dispYn": "text",
"dispStrDtm": "2026-01-01T00:00:00.000Z",
"layoutJson": "text",
"useYn": "text"
}기획전번호
14862언어코드
ko기획전 구분자정보 조회 성공
기획전 구분자 정보
언어코드
ko기획전번호
14862구분자번호
1전시매체코드(DP018)
99구분자구분코드(DP024)
10구분자명
구분자명전시여부
Y전시순서
1템플릿번호
10020쿠폰번호
C1001442텍스트구분자명
텍스트구분자명배너이미지경로명
/이미지경로명배너이미지파일명
이미지파일명쿠폰배너이미지경로명
/쿠폰이미지경로명쿠폰배너이미지대체텍스트
쿠폰이미지대체텍스트쿠폰배너이미지파일명
쿠폰이미지파일명HTML파일내용
HTML내용구분자상태
I기획전 구분자정보 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getMarketingDisplayMgmtDivobj?mkdpNo=text&langCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"dispMediaCd": 99,
"divobjGbCd": 10,
"divobjNm": "구분자명",
"dispYn": "Y",
"dispSeq": 1,
"tmplNo": 10020,
"cpnNo": "C1001442",
"textDivobjNm": "텍스트구분자명",
"bnrImgPathNm": "/이미지경로명",
"bnrImgFileNm": "이미지파일명",
"cpnBnrImgPathNm": "/쿠폰이미지경로명",
"bnrImgAltCont": "쿠폰이미지대체텍스트",
"cpnBnrImgFileNm": "쿠폰이미지파일명",
"htmlFileCont": "HTML내용",
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"stateForm": "I"
}기획전번호
14862기획전 구분자정보 목록 조회 성공
기획전 구분자 정보
언어코드
ko기획전번호
14862구분자번호
1전시매체코드(DP018)
99구분자구분코드(DP024)
10구분자명
구분자명전시여부
Y전시순서
1템플릿번호
10020쿠폰번호
C1001442텍스트구분자명
텍스트구분자명배너이미지경로명
/이미지경로명배너이미지파일명
이미지파일명쿠폰배너이미지경로명
/쿠폰이미지경로명쿠폰배너이미지대체텍스트
쿠폰이미지대체텍스트쿠폰배너이미지파일명
쿠폰이미지파일명HTML파일내용
HTML내용구분자상태
I기획전 구분자정보 목록 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getMarketingDisplayDivobjGridList?mkdpNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"dispMediaCd": 99,
"divobjGbCd": 10,
"divobjNm": "구분자명",
"dispYn": "Y",
"dispSeq": 1,
"tmplNo": 10020,
"cpnNo": "C1001442",
"textDivobjNm": "텍스트구분자명",
"bnrImgPathNm": "/이미지경로명",
"bnrImgFileNm": "이미지파일명",
"cpnBnrImgPathNm": "/쿠폰이미지경로명",
"bnrImgAltCont": "쿠폰이미지대체텍스트",
"cpnBnrImgFileNm": "쿠폰이미지파일명",
"htmlFileCont": "HTML내용",
"imgList": [
{
"langCd": "ko",
"dispShopGbCd": "01",
"shopCtgNo": 132,
"imgTypCd": "01",
"imgSn": 133,
"bnrImgPathNm": "/배너이미지경로",
"bnrImgFileNm": "배너이미지파일명",
"bnrImgAltCont": "배너이미지 대체텍스트",
"linkUrlAddr": "/연결URL주소",
"dispMediaCd": 99,
"dispStat": 10,
"contPathNm": "/썸네일이미지경로",
"contGbCd": "text",
"copyShopCtgNo": "text",
"fileIdx": 1
}
],
"stateForm": "I"
}기획전번호
14862구분자번호
1상품번호Array
기획전 구분자별 상품 목록 조회 및 세팅 성공
기획전상품정보
언어코드
ko기획전번호
14862구분자번호
1상품번호
10002131상품명
상품명전시순서
1판매상태코드
10판매상태코드명
판매중협력사번호
1000002협력사명
플래티어 협력사정상가
25000할인가
20000오류메시지
해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.오류상태
타임딜적용여부
타임딜시작일시
타임딜종료일시
타임딜판매가
기획전 구분자별 상품 목록 조회 및 세팅 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getGoodsListDetail?mkdpNo=text&divobjNo=text&goodsArray=undefined HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}기획전번호
14862구분자번호
1기획전 구분자별 상품 목록 조회 성공
기획전상품정보
언어코드
ko기획전번호
14862구분자번호
1상품번호
10002131상품명
상품명전시순서
1판매상태코드
10판매상태코드명
판매중협력사번호
1000002협력사명
플래티어 협력사정상가
25000할인가
20000오류메시지
해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.오류상태
타임딜적용여부
타임딜시작일시
타임딜종료일시
타임딜판매가
기획전 구분자별 상품 목록 조회 실패
GET /api/bo/v1/display/marketingDisplayMgmt/getDivobjGoodsGridList?mkdpNo=text&divobjNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"langCd": "ko",
"mkdpNo": 14862,
"divobjNo": 1,
"goodsNo": 10002131,
"goodsNm": "상품명",
"dispSeq": 1,
"saleStatCd": 10,
"saleStatCdNm": "판매중",
"entrNo": 1000002,
"entrNm": "플래티어 협력사",
"norPrc": 25000,
"salePrc": 20000,
"errorMessage": "해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.",
"validStat": "text",
"timeDealYn": "text",
"tmdlHistStrDtm": "2026-01-01T00:00:00.000Z",
"tmdlHistEndDtm": "2026-01-01T00:00:00.000Z",
"tmdlSalePrc": 1
}OK
result time
result code
result message
process check
payload
is error
GET /api/bo/v1/display/marketingDisplayMgmt/convertPlanLayout?mkdpNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
OK
{
"timestamp": "2026-01-01T00:00:00.000Z",
"code": "text",
"message": "text",
"isProcess": true,
"payload": null,
"error": true,
"errors": [
{
"field": "text",
"message": "text"
}
]
}마지막 업데이트