본문으로 건너뛰기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

기획전 정보 관리

기획전 등록/수정 팝업 구분자탭 저장

post

기능설명

  • 기획전 등록/수정 팝업_구분자 탭을 등록/수정/삭제 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 *

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
filesstring · binary[]Optional
Responses
200

기획전 구분자탭 저장 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/savePrMkdpDivobj
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"
    }
  ]
}

기획전 등록/수정 팝업 기본정보 탭 - 기획전 구분자 다국어 저장

post

기능설명

  • 기획전 구분자 다국어 정보를 저장하는 API 입니다.


상세설명

  • 구분자 기본정보 유형에 따라 다국어 정보를 입력할 수 있습니다. (HTML -> HTML, 배너 -> 배너, 텍스트 -> 텍스트)

  • 구분자 다국어명은 구분자 상품 리스트에서 상품을 구분짓는 구분자 다국어 명으로 사용됩니다.

  • 입력 파라미터( * : 필수)

    • update : mkdpNo *, divobjNo *, divobjNm *, txtDivobjNm, bnrImagPathNm, bnrImgFileNm, cpnBnrImgPathNm, cpnBnrImgFileNm, htmlFileCont, langCd *

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
filesstring · binary[]Optional
Responses
200

기획전 구분자정보 다국어 저장 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/savePrMkdpDivobjMl
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"
    }
  ]
}

기획전 등록/수정 팝업_기본정보 탭 저장

post

기능설명

  • 기획전 등록/수정 팝업_기본정보 탭을 등록 및 수정하는 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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
filesstring · binary[]Optional
Responses
200

기획전 기본정보 탭 등록/수정 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/savePrMkdpBase
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"
    }
  ]
}

기획전 구성안 목록 전시여부·전시순서 저장

post

기능설명

  • 기획전 구성안 목록 그리드에서 고친 전시여부·전시순서만 저장하는 API 입니다.


상세설명

  • 기획전 관리 목록의 저장(saveMarketingDisplayMgmtList)과 경로를 나눕니다 — 그 쪽은 전시기간까지 함께 덮으므로, 목록을 조회한 뒤 다른 운영자가 편집기에서 기간을 바꾸면 먼저 조회한 목록에서 순서만 저장해도 그 기간이 옛 값으로 되돌아갑니다.

  • 전시순서는 필수이며 1 이상입니다. 같은 순서가 여럿인 것은 막지 않습니다.

  • 수정자는 받지 않고 로그인 사용자로 채웁니다.

  • 삭제 목록이 없습니다 — 기획전 삭제는 기획전 정보 관리가 맡습니다.

  • 저장 후 해당 기획전들의 FO 캐시를 무효화합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

기획전 구성안 목록 전시여부·전시순서 저장 요청

Responses
200

저장 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadanyOptional

payload

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/savePlanLayoutDispList
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"
    }
  ]
}

기획전 구성안 저장

post

기능설명

  • 기획전의 구성안 문서(LayoutDocument)를 저장하는 API 입니다.


상세설명

  • 없으면 만들고 있으면 덮습니다. 기획전 하나에 문서 한 벌입니다.

  • 게시 단계가 없습니다. 저장하면 곧 화면입니다 — 구좌로 저작하던 때와 같고, 노출 여부·기간은 기획전 기본정보가 갖습니다. 저장 전 확인은 미리보기가 맡습니다.

  • 저장 후 해당 기획전의 FO 캐시를 무효화합니다.

  • 사이트·전시몰은 기획전 기본정보에서 가져옵니다. 요청에서 받지 않습니다 — 받으면 같은 기획전의 문서가 딴 사이트 자리에 저장될 수 있습니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

기획전 구성안 저장 요청

mkdpNostringOptional

기획전번호

Example: 14862
layoutDocanyOptional

레이아웃 문서(LayoutDocument)

layoutSysModDtmstringOptional

문서를 읽어 간 시각(동시 저장 검사용)

Responses
200

기획전 구성안 저장 성공

*/*

기획전 구성안

siteNostringOptional

사이트번호

layoutSysModDtmstringOptional

동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)

layoutNostringOptional

레이아웃번호

layoutNmstringOptional

레이아웃명

shopTypCdstringOptional

매장유형코드(DP003)

dispTgtNostringOptional

전시대상번호(기획전번호)

dpmlNostringOptional

전시몰번호

dispYnstringOptional

전시여부

dispStrDtmstring · date-timeOptional

전시시작일시

layoutJsonstringOptional

레이아웃 JSON

useYnstringOptional

사용여부

post/v1/display/marketingDisplayMgmt/savePlanLayoutConfig
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"
}

기획전 편집기 저장(기본정보+구성안)

post

기능설명

  • 기획전 구성안 편집기의 저장입니다. 기본정보와 구성안 문서를 한 트랜잭션에서 씁니다.


상세설명

  • 기획전번호가 비어 있으면 새 기획전을 만듭니다 — 등록과 첫 저장이 한 번에 끝납니다.

  • 템플릿번호는 받지 않습니다. 이 편집기로 저장한 기획전은 언제나 구성안(위지윅)이고, 번호는 환경마다 다르게 채번되므로 서버가 템플릿 파일명으로 찾습니다.

  • 그룹은 이름으로 다룹니다. 그룹번호 없이 이름만 오면 같은 사이트·전시몰에서 찾아보고, 없으면 새로 만듭니다. 이름까지 비면 그룹 미지정입니다.

  • 저장 후 해당 기획전의 FO 캐시를 무효화합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
filesstring · binary[]Optional
Responses
200

기획전 편집기 저장 성공

*/*

기획전기본

siteNostringOptional

사이트번호

Example: 1
langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
mkdpNmstringOptional

기획전명

Example: 기획전 제목
siteNmstringOptional

사이트명

Example: 플래티어닷컴
dpmlNostringOptional

몰번호

Example: 10001
tmplNostringOptional

템플릿번호

Example: 10020
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
dispStrDtmstring · date-timeOptional

전시시작일시

Example: 2023-01-01 00:00:00.000
dispEndDtmstring · date-timeOptional

전시종료일시

Example: 2023-12-31 00:00:00.000
mdIdstringOptional

담당MD

Example: tester
mkdpTtlHtmlstringOptional

기획전타이틀HTML_MO

Example: HTML_MO
mkdpTtlHtmlPcstringOptional

기획전타이틀HTML_PC

Example: HTML_PC
htmlContYnstringOptional

HTML컨텐츠여부

Example: N
kwdNmstringOptional

키워드명

Example: 키워드명
brefDescstringOptional

간략설명

Example: 간략설명
introContsstringOptional

소개글

Example: 소개글
fotrFileContsstringOptional

푸터파일내용

Example: 푸터파일내용
aplyBrandstring[]Optional

기획전브랜드리스트

Example: [100001,100002]
pcTtopExpYnstringOptional

PC상단노출여부

Example: Y
dispGrpNostringOptional

전시그룹번호

Example: 132
dispMediaCdstringOptional

전시매체코드

Example: 20
dispStafYnstringOptional

임직원여부

Example: Y
tmplFileNmstringOptional

템플릿파일명

Example: MarketingTemplate1
dispGrpNoListstring[]Optional
mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]
bnrImgPathNmstringOptional

배너이미지경로명

bnrImgAltContstringOptional

배너이미지대체텍스트

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional
dispStatNamestringOptional
dispMediaNmstringOptional
post/v1/display/marketingDisplayMgmt/savePlanEditor
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"
}
Deprecated

기획전 등록/수정 팝업 상품정보 탭 - 상품 엑셀 일괄 저장

post

기능설명

  • 상품정보 탭 > 상품 일괄등록탭 - 상품 엑셀 일괄 저장하는 API 입니다.


상세설명

  • 엘셀 상품 등록시 중복된 상품을 제외하고 등록합니다.

  • 중복된 상품이 있을경우 해당 중복된 상품은 리스트형식으로 리턴됩니다.

  • 입력 파라미터( * : 필수)

    • 필요 값 : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Bodyobject · PrMkdpGoodsInfo[]

기획전상품정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
goodsNostringOptional

상품번호

Example: 10002131
goodsNmstringOptional

상품명

Example: 상품명
dispSeqinteger · int32Optional

전시순서

Example: 1
saleStatCdstringOptional

판매상태코드

Example: 10
saleStatCdNmstringOptional

판매상태코드명

Example: 판매중
entrNostringOptional

협력사번호

Example: 1000002
entrNmstringOptional

협력사명

Example: 플래티어 협력사
norPrcnumberOptional

정상가

Example: 25000
salePrcnumberOptional

할인가

Example: 20000
errorMessagestringOptional

오류메시지

Example: 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.
validStatstringOptional

오류상태

timeDealYnstringOptional

타임딜적용여부

tmdlHistStrDtmstring · date-timeOptional

타임딜시작일시

tmdlHistEndDtmstring · date-timeOptional

타임딜종료일시

tmdlSalePrcnumberOptional

타임딜판매가

Responses
200

기획전 상품 엑셀 일괄 저장 성공

*/*

기획전상품정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
goodsNostringOptional

상품번호

Example: 10002131
goodsNmstringOptional

상품명

Example: 상품명
dispSeqinteger · int32Optional

전시순서

Example: 1
saleStatCdstringOptional

판매상태코드

Example: 10
saleStatCdNmstringOptional

판매상태코드명

Example: 판매중
entrNostringOptional

협력사번호

Example: 1000002
entrNmstringOptional

협력사명

Example: 플래티어 협력사
norPrcnumberOptional

정상가

Example: 25000
salePrcnumberOptional

할인가

Example: 20000
errorMessagestringOptional

오류메시지

Example: 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.
validStatstringOptional

오류상태

timeDealYnstringOptional

타임딜적용여부

tmdlHistStrDtmstring · date-timeOptional

타임딜시작일시

tmdlHistEndDtmstring · date-timeOptional

타임딜종료일시

tmdlSalePrcnumberOptional

타임딜판매가

post/v1/display/marketingDisplayMgmt/saveMarketingMgmtExcelGoodsList
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
}

기획전 정보 관리 목록 저장

post

기능설명

  • 기획전 정보관리 목록을 수정/삭제하는 API 입니다.


상세설명

  • realGrid를 통해 해당 기획전 관리 - 기횐전 정보를 수정/삭제 합니다.

  • 입력 파라미터( * : 필수)

    • update : mkdpNo *, dispYn *, dispSeq *, dispStrDtm *, dispEndDtm *

    • delete : mkdpNo *

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
Responses
200

기획전 목록 저장 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtList
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"
    }
  ]
}

기획전 등록/수정 팝업 기본정보 탭 - 기획전 기본정보 다국어 저장

post

기능설명

  • 기획전 기본정보 다국어 정보를 저장하는 API 입니다.


상세설명

  • 리스트 콘텐츠1, 리스트 콘텐츠2는 필수값입니다. 또한 전시매체 PC, MO 하나씩 등록하거나 공통을 등록 할 수 있습니다.

  • 입력 파라미터( * : 필수)

    • update : mkdpNo *, mkdpNm *, mkdpTtlHtml , mkdpTtlHtmlPc , brefDesc, introConts, fotrFileConts, langcd *

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
filesstring · binary[]Optional
Responses
200

기획전 기본정보 다국어 저장 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtBaseMl
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"
    }
  ]
}

기획전 등록/수정 팝업 상품정보 탭 - 상품 그리드 저장

post

기능설명

  • 상품정보 탭 - 상품 그리드 등록/수정/삭제하는 API 입니다.


상세설명

  • realGrid를 통해 해당 상품 목록 정보를 저장합니다.

  • 입력 파라미터( * : 필수)

    • create : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *

    • update : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *

    • delete : mkdpNo *, divobjNo *, goodsNo *, itmNo *

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
Responses
200

기획전 상품 정보 저장 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/saveDivobjGoodsGridList
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"
    }
  ]
}

기획전 등록/수정 팝업 상품정보 탭 - 상품 엑셀 일괄 저장

post

기능설명

  • 상품정보 탭 > 상품 일괄등록탭 - 상품 엑셀 일괄 저장하는 API 입니다.


상세설명

  • 엑셀 상품 등록시 중복된 상품을 제외하고 등록합니다.

  • 상품 예외상황 발생 시 상품에 에러메시지를 담아서 결과값을 반환합니다.

  • 일반상품만 등록이 가능합니다.

  • 입력 파라미터( * : 필수)

    • 필요 값 : mkdpNo *, divobjNo *, goodsNo *, itmNo *, dispSeq *


특이사항 (에러메시지)

  • 존재X or 묶음상품 : 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.

  • 중복상품, 중복입력상품 : 이미 추가된 상품입니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Bodyobject · PrMkdpGoodsInfo[]

기획전상품정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
goodsNostringOptional

상품번호

Example: 10002131
goodsNmstringOptional

상품명

Example: 상품명
dispSeqinteger · int32Optional

전시순서

Example: 1
saleStatCdstringOptional

판매상태코드

Example: 10
saleStatCdNmstringOptional

판매상태코드명

Example: 판매중
entrNostringOptional

협력사번호

Example: 1000002
entrNmstringOptional

협력사명

Example: 플래티어 협력사
norPrcnumberOptional

정상가

Example: 25000
salePrcnumberOptional

할인가

Example: 20000
errorMessagestringOptional

오류메시지

Example: 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.
validStatstringOptional

오류상태

timeDealYnstringOptional

타임딜적용여부

tmdlHistStrDtmstring · date-timeOptional

타임딜시작일시

tmdlHistEndDtmstring · date-timeOptional

타임딜종료일시

tmdlSalePrcnumberOptional

타임딜판매가

Responses
200

기획전 상품 엑셀 일괄 저장 성공

*/*

기획전상품정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
goodsNostringOptional

상품번호

Example: 10002131
goodsNmstringOptional

상품명

Example: 상품명
dispSeqinteger · int32Optional

전시순서

Example: 1
saleStatCdstringOptional

판매상태코드

Example: 10
saleStatCdNmstringOptional

판매상태코드명

Example: 판매중
entrNostringOptional

협력사번호

Example: 1000002
entrNmstringOptional

협력사명

Example: 플래티어 협력사
norPrcnumberOptional

정상가

Example: 25000
salePrcnumberOptional

할인가

Example: 20000
errorMessagestringOptional

오류메시지

Example: 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.
validStatstringOptional

오류상태

timeDealYnstringOptional

타임딜적용여부

tmdlHistStrDtmstring · date-timeOptional

타임딜시작일시

tmdlHistEndDtmstring · date-timeOptional

타임딜종료일시

tmdlSalePrcnumberOptional

타임딜판매가

post/v1/display/marketingDisplayMgmt/saveBulkDivobjGoodsUpload
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
}

기획전 관리 - 기획전 단건 복사

post

기능설명

  • 기획전 정보를 단건 복사하는 API 입니다.


상세설명

  • 기획전 복사시 복사된 기획전 명은 '기획전명 + (복사)' 형식으로 저장됩니다.

  • 복사된 기획전의 전시여부는 전시안함으로 고정됩니다.

  • 입력 파라미터( * : 필수)

    • 필요 값 : mkdpNo *


수정번호

  • Release v1.05_231204 : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

기획전기본

siteNostringOptional

사이트번호

Example: 1
langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
mkdpNmstringOptional

기획전명

Example: 기획전 제목
siteNmstringOptional

사이트명

Example: 플래티어닷컴
dpmlNostringOptional

몰번호

Example: 10001
tmplNostringOptional

템플릿번호

Example: 10020
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
dispStrDtmstring · date-timeOptional

전시시작일시

Example: 2023-01-01 00:00:00.000
dispEndDtmstring · date-timeOptional

전시종료일시

Example: 2023-12-31 00:00:00.000
mdIdstringOptional

담당MD

Example: tester
mkdpTtlHtmlstringOptional

기획전타이틀HTML_MO

Example: HTML_MO
mkdpTtlHtmlPcstringOptional

기획전타이틀HTML_PC

Example: HTML_PC
htmlContYnstringOptional

HTML컨텐츠여부

Example: N
kwdNmstringOptional

키워드명

Example: 키워드명
brefDescstringOptional

간략설명

Example: 간략설명
introContsstringOptional

소개글

Example: 소개글
fotrFileContsstringOptional

푸터파일내용

Example: 푸터파일내용
aplyBrandstring[]Optional

기획전브랜드리스트

Example: [100001,100002]
pcTtopExpYnstringOptional

PC상단노출여부

Example: Y
dispGrpNostringOptional

전시그룹번호

Example: 132
dispMediaCdstringOptional

전시매체코드

Example: 20
dispStafYnstringOptional

임직원여부

Example: Y
tmplFileNmstringOptional

템플릿파일명

Example: MarketingTemplate1
dispGrpNoListstring[]Optional
mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]
bnrImgPathNmstringOptional

배너이미지경로명

bnrImgAltContstringOptional

배너이미지대체텍스트

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional
dispStatNamestringOptional
dispMediaNmstringOptional
Responses
200

기획전 복사 성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/registerCopyMarketingDisplayMgmt
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"
    }
  ]
}
Deprecated

기획전 상품 일괄등록의 중복, 존재하지 않는 상품 제외 리스트 조회

post

기능설명

  • 기획전 상품 일괄등록의Ø 중복, 존재하지 않는 상품 제외하고 해당 리스트를 리턴하는 API 입니다.


상세설명

  • 상품 예외상황 발생 시 상품에 에러메시지를 담아서 결과값을 반환합니다.

  • 일반상품만 등록이 가능합니다.


특이사항 (에러메시지)

  • 존재X or 묶음상품 : 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.

  • 중복상품 : 상품번호는 중복이 불가능합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
divobjNostringRequired

구분자번호

Example: 1
goodsInfoListListRequired

상품정보리스트

Body

기획전상품정보 Search 모델

mkdpNostringOptional

기획전번호

divobjNostringOptional

구분자번호

goodsNostringOptional

상품번호

dispSeqinteger · int32Optional

전시순서

goodsArraystring[]Optional

상품번호 배열

Responses
200

OK

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

post/v1/display/marketingDisplayMgmt/getValidPlanShopGoodsList
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
    }
  ]
}
200

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"
    }
  ]
}

기획전 구성안 상품 유닛 조회

get

기능설명

  • 상품번호 목록으로 고객 화면이 받는 것과 같은 상품 값을 조회합니다.


상세설명

  • 구성안은 상품번호만 저장합니다. 이름·가격·할인·브랜드·아이콘은 상품 쪽에서 바뀌므로 구성안에 베껴 두지 않고 그릴 때 번호로 받아 갑니다.

  • api-display 의 전시상품 조회를 그대로 전달합니다 — 저작 화면과 고객 화면이 같은 값을 써야 "저장했는데 다르게 보인다" 가 생기지 않습니다.

  • 조회에 실패해도 빈 목록을 돌려줍니다. 상품 자리만 비고 구성안은 그려집니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
goodsNoListstring[]Required

상품번호 목록

Example: 10001741,10001791
Responses
200

OK

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v1/display/marketingDisplayMgmt/planGoodsUnits
GET /api/bo/v1/display/marketingDisplayMgmt/planGoodsUnits?goodsNoList=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

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"
    }
  ]
}

기획전 팝업 구분자탭 탭 - 구분자 다국어 정보 조회

get

기능설명

  • 기획전 구분자 다국어 정보를 조회하는 API 입니다.


상세설명

  • 기획전번호,언어코드를 받아 기획전 구분자 다국어 정보를 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
divobjNostringRequired

구분자번호

Example: 1
langCdstringRequired

언어코드

Example: en
Responses
200

기획전 구분자 다국어정보 조회 성공

*/*

기획전 구분자 정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
dispMediaCdstringOptional

전시매체코드(DP018)

Example: 99
divobjGbCdstringOptional

구분자구분코드(DP024)

Example: 10
divobjNmstringOptional

구분자명

Example: 구분자명
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
tmplNostringOptional

템플릿번호

Example: 10020
cpnNostringOptional

쿠폰번호

Example: C1001442
textDivobjNmstringOptional

텍스트구분자명

Example: 텍스트구분자명
bnrImgPathNmstringOptional

배너이미지경로명

Example: /이미지경로명
bnrImgFileNmstringOptional

배너이미지파일명

Example: 이미지파일명
cpnBnrImgPathNmstringOptional

쿠폰배너이미지경로명

Example: /쿠폰이미지경로명
bnrImgAltContstringOptional

쿠폰배너이미지대체텍스트

Example: 쿠폰이미지대체텍스트
cpnBnrImgFileNmstringOptional

쿠폰배너이미지파일명

Example: 쿠폰이미지파일명
htmlFileContstringOptional

HTML파일내용

Example: HTML내용
stateFormstringOptional

구분자상태

Example: I
get/v1/display/marketingDisplayMgmt/getPrMkdpDivobjMultiLanguage
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"
}

기획전 팝업 기본정보 탭 - 기본정보 다국어 조회

get

기능설명

  • 기획전 기본정보 다국어 상세정보를 조회하는 API 입니다.


상세설명

  • 기획전번호,언어코드를 받아 기획전 다국어 기본 정보를 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
langCdstringRequired

언어코드

Example: en
Responses
200

기획전 기본정보 다국어 조회 성공

*/*

기획전기본

siteNostringOptional

사이트번호

Example: 1
langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
mkdpNmstringOptional

기획전명

Example: 기획전 제목
siteNmstringOptional

사이트명

Example: 플래티어닷컴
dpmlNostringOptional

몰번호

Example: 10001
tmplNostringOptional

템플릿번호

Example: 10020
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
dispStrDtmstring · date-timeOptional

전시시작일시

Example: 2023-01-01 00:00:00.000
dispEndDtmstring · date-timeOptional

전시종료일시

Example: 2023-12-31 00:00:00.000
mdIdstringOptional

담당MD

Example: tester
mkdpTtlHtmlstringOptional

기획전타이틀HTML_MO

Example: HTML_MO
mkdpTtlHtmlPcstringOptional

기획전타이틀HTML_PC

Example: HTML_PC
htmlContYnstringOptional

HTML컨텐츠여부

Example: N
kwdNmstringOptional

키워드명

Example: 키워드명
brefDescstringOptional

간략설명

Example: 간략설명
introContsstringOptional

소개글

Example: 소개글
fotrFileContsstringOptional

푸터파일내용

Example: 푸터파일내용
aplyBrandstring[]Optional

기획전브랜드리스트

Example: [100001,100002]
pcTtopExpYnstringOptional

PC상단노출여부

Example: Y
dispGrpNostringOptional

전시그룹번호

Example: 132
dispMediaCdstringOptional

전시매체코드

Example: 20
dispStafYnstringOptional

임직원여부

Example: Y
tmplFileNmstringOptional

템플릿파일명

Example: MarketingTemplate1
dispGrpNoListstring[]Optional
mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]
bnrImgPathNmstringOptional

배너이미지경로명

bnrImgAltContstringOptional

배너이미지대체텍스트

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional
dispStatNamestringOptional
dispMediaNmstringOptional
get/v1/display/marketingDisplayMgmt/getPrMkdpBaseMultiLanguage
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"
}

기획전 정보 관리 - 기획전 정보 목록 조회

get

기능설명

  • 기획전 정보 목록을 조회하는 API 입니다.


상세설명

  • 기획전번호,기획전명,담당MD,사용자아이디,전시여부,브랜드명,전시시작날짜,전시종료날짜,기획전상태,사이트번호,그룹번호 조회조건에 따라 기획전 정보를 조회합니다.

    • 사이트번호, 사이트기준 몰번호, 몰 기준 전시그룹번호로 조회합니다.

  • 기획전 정보 목록은 전시순서 내림차순, 전시시작날짜 내림차순으로 노출됩니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringOptional

기획전번호

Example: 14862
mkdpNmstringOptional

기획전명

Example: 성능테스트 기획전
mdIdstringOptional

담당MD

dispMediaCdstringOptional

전시매체코드(DP018)

Example: 99
userIdstringOptional

사용자아이디

dispYnstringOptional

전시여부

Example: Y
brandNmstringOptional

브랜드명

startDatestringOptional

전시시작날짜

Example: 20230101
endDatestringOptional

전시종료날짜

Example: 20991231
dispStatstringOptional

기획전상태

Example: 20
siteNostringOptional

사이트번호

Example: 1
dpmlNostringOptional

몰번호

Example: 10001
dispGrpNostringOptional

전시그룹번호

Example: 132
rowsPerPagestringRequired

페이지 당 row

Example: 100
pageIdxstringRequired

현재 페이지

Example: 1
Responses
200

기획전 정보 조회 성공

*/*

기획전기본

siteNostringOptional

사이트번호

Example: 1
langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
mkdpNmstringOptional

기획전명

Example: 기획전 제목
siteNmstringOptional

사이트명

Example: 플래티어닷컴
dpmlNostringOptional

몰번호

Example: 10001
tmplNostringOptional

템플릿번호

Example: 10020
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
dispStrDtmstring · date-timeOptional

전시시작일시

Example: 2023-01-01 00:00:00.000
dispEndDtmstring · date-timeOptional

전시종료일시

Example: 2023-12-31 00:00:00.000
mdIdstringOptional

담당MD

Example: tester
mkdpTtlHtmlstringOptional

기획전타이틀HTML_MO

Example: HTML_MO
mkdpTtlHtmlPcstringOptional

기획전타이틀HTML_PC

Example: HTML_PC
htmlContYnstringOptional

HTML컨텐츠여부

Example: N
kwdNmstringOptional

키워드명

Example: 키워드명
brefDescstringOptional

간략설명

Example: 간략설명
introContsstringOptional

소개글

Example: 소개글
fotrFileContsstringOptional

푸터파일내용

Example: 푸터파일내용
aplyBrandstring[]Optional

기획전브랜드리스트

Example: [100001,100002]
pcTtopExpYnstringOptional

PC상단노출여부

Example: Y
dispGrpNostringOptional

전시그룹번호

Example: 132
dispMediaCdstringOptional

전시매체코드

Example: 20
dispStafYnstringOptional

임직원여부

Example: Y
tmplFileNmstringOptional

템플릿파일명

Example: MarketingTemplate1
dispGrpNoListstring[]Optional
mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]
bnrImgPathNmstringOptional

배너이미지경로명

bnrImgAltContstringOptional

배너이미지대체텍스트

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional
dispStatNamestringOptional
dispMediaNmstringOptional
get/v1/display/marketingDisplayMgmt/getPrMkdpBaseList
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"
}

기획전 팝업 - 기획전 정보 상세 조회

get

기능설명

  • 기획전 상세 정보를 조회하는 API 입니다.


상세설명

  • 기획전번호,언어코드를 받아 기획전 상세 정보를 조회합니다.


수정번호

  • Release v1.05_231204 : 스프린트5 PO1 결함/개선 - 쿼리 where절 개선

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
langCdstringRequired

언어코드

Example: ko
Responses
200

기획전 상세정보 조회 성공

*/*

기획전기본

siteNostringOptional

사이트번호

Example: 1
langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
mkdpNmstringOptional

기획전명

Example: 기획전 제목
siteNmstringOptional

사이트명

Example: 플래티어닷컴
dpmlNostringOptional

몰번호

Example: 10001
tmplNostringOptional

템플릿번호

Example: 10020
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
dispStrDtmstring · date-timeOptional

전시시작일시

Example: 2023-01-01 00:00:00.000
dispEndDtmstring · date-timeOptional

전시종료일시

Example: 2023-12-31 00:00:00.000
mdIdstringOptional

담당MD

Example: tester
mkdpTtlHtmlstringOptional

기획전타이틀HTML_MO

Example: HTML_MO
mkdpTtlHtmlPcstringOptional

기획전타이틀HTML_PC

Example: HTML_PC
htmlContYnstringOptional

HTML컨텐츠여부

Example: N
kwdNmstringOptional

키워드명

Example: 키워드명
brefDescstringOptional

간략설명

Example: 간략설명
introContsstringOptional

소개글

Example: 소개글
fotrFileContsstringOptional

푸터파일내용

Example: 푸터파일내용
aplyBrandstring[]Optional

기획전브랜드리스트

Example: [100001,100002]
pcTtopExpYnstringOptional

PC상단노출여부

Example: Y
dispGrpNostringOptional

전시그룹번호

Example: 132
dispMediaCdstringOptional

전시매체코드

Example: 20
dispStafYnstringOptional

임직원여부

Example: Y
tmplFileNmstringOptional

템플릿파일명

Example: MarketingTemplate1
dispGrpNoListstring[]Optional
mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]
bnrImgPathNmstringOptional

배너이미지경로명

bnrImgAltContstringOptional

배너이미지대체텍스트

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional
dispStatNamestringOptional
dispMediaNmstringOptional
get/v1/display/marketingDisplayMgmt/getPrMkdpBaseDetail
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"
}

기획전 팝업 - 기획전 이미지 상세 조회

get

기능설명

  • 기획전 이미지 상세 정보를 조회하는 API 입니다.


상세설명

  • 기획전번호,언어코드를 받아 기획전 이미지 상세 정보를 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
langCdstringRequired

언어코드

Example: ko
Responses
200

기획전 상세 이미지 조회 성공

*/*

전시이미지정보

langCdstringOptional

언어코드

Example: ko
dispShopGbCdstringOptional

전시매장구분코드(DP009)

Example: 01
shopCtgNostringOptional

매장카테고리번호

Example: 132
imgTypCdstringOptional

이미지유형코드(DP013)

Example: 01
imgSnstringOptional

이미지일련번호

Example: 133
bnrImgPathNmstringOptional

배너이미지경로명

Example: /배너이미지경로
bnrImgFileNmstringOptional

배너이미지파일명

Example: 배너이미지파일명
bnrImgAltContstringOptional

배너이미지 대체텍스트

Example: 배너이미지 대체텍스트
linkUrlAddrstringOptional

연결URL주소

Example: /연결URL주소
dispMediaCdstringOptional

전시매체코드(DP018)

Example: 99
dispStatstringOptional

기획전상태

Example: 10
contPathNmstringOptional

썸네일이미지경로

Example: /썸네일이미지경로
contGbCdstringOptional

콘텐츠구분코드(SN007)

copyShopCtgNostringOptional

매장카테코리번호(복사)

fileIdxinteger · int32Optional

이미지업로드 순번

get/v1/display/marketingDisplayMgmt/getPrDispImgInfoDetail
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
}

기획전 구성안 조회

get

기능설명

  • 기획전의 구성안 문서(LayoutDocument)를 조회하는 API 입니다.


상세설명

  • 기획전 하나에 문서 한 벌입니다. 전시위치는 기획전 자신이며 따로 고르지 않습니다.

  • 아직 저작하지 않은 기획전이면 payload 가 비어 있습니다 — 오류가 아닙니다.

  • 전시 스튜디오(구성안 관리) 화면은 기획전 문서를 다루지 않습니다. 기획전 문서는 이 경로로만 읽고 씁니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
Responses
200

기획전 구성안 조회 성공

*/*

기획전 구성안

siteNostringOptional

사이트번호

layoutSysModDtmstringOptional

동시 저장 검사용 문서 버전(해석하지 말고 그대로 돌려보낸다)

layoutNostringOptional

레이아웃번호

layoutNmstringOptional

레이아웃명

shopTypCdstringOptional

매장유형코드(DP003)

dispTgtNostringOptional

전시대상번호(기획전번호)

dpmlNostringOptional

전시몰번호

dispYnstringOptional

전시여부

dispStrDtmstring · date-timeOptional

전시시작일시

layoutJsonstringOptional

레이아웃 JSON

useYnstringOptional

사용여부

get/v1/display/marketingDisplayMgmt/getPlanLayoutConfig
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"
}

기획전 팝업 구분자탭 탭 - 구분자정보 조회

get

기능설명

  • 기획전 구분자 상세정보를 조회하는 API 입니다.


상세설명

  • 기획전번호,언어코드를 받아 기획전 구분자 정보를 조회합니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
langCdstringRequired

언어코드

Example: ko
Responses
200

기획전 구분자정보 조회 성공

*/*

기획전 구분자 정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
dispMediaCdstringOptional

전시매체코드(DP018)

Example: 99
divobjGbCdstringOptional

구분자구분코드(DP024)

Example: 10
divobjNmstringOptional

구분자명

Example: 구분자명
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
tmplNostringOptional

템플릿번호

Example: 10020
cpnNostringOptional

쿠폰번호

Example: C1001442
textDivobjNmstringOptional

텍스트구분자명

Example: 텍스트구분자명
bnrImgPathNmstringOptional

배너이미지경로명

Example: /이미지경로명
bnrImgFileNmstringOptional

배너이미지파일명

Example: 이미지파일명
cpnBnrImgPathNmstringOptional

쿠폰배너이미지경로명

Example: /쿠폰이미지경로명
bnrImgAltContstringOptional

쿠폰배너이미지대체텍스트

Example: 쿠폰이미지대체텍스트
cpnBnrImgFileNmstringOptional

쿠폰배너이미지파일명

Example: 쿠폰이미지파일명
htmlFileContstringOptional

HTML파일내용

Example: HTML내용
stateFormstringOptional

구분자상태

Example: I
get/v1/display/marketingDisplayMgmt/getMarketingDisplayMgmtDivobj
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"
}

기획전 등록/수정 팝업 상품정보 탭 - 기획전 구분자 그리드 목록 조회

get

기능설명

  • 상품정보 탭 - 기획전 구분자 그리드 목록을 조회하는 API 입니다.


상세설명

  • 기획전 번호를 받아 기획전 구분자 목록을 조회합니다.

  • 기획전 구분자 목록은 전시순서,구분자번호 오름차순으로 노출됩니다.


수정번호

Release v1.02_231023 : 스프린트2 PO1 결함/개선

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
Responses
200

기획전 구분자정보 목록 조회 성공

*/*

기획전 구분자 정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
dispMediaCdstringOptional

전시매체코드(DP018)

Example: 99
divobjGbCdstringOptional

구분자구분코드(DP024)

Example: 10
divobjNmstringOptional

구분자명

Example: 구분자명
dispYnstringOptional

전시여부

Example: Y
dispSeqinteger · int32Optional

전시순서

Example: 1
tmplNostringOptional

템플릿번호

Example: 10020
cpnNostringOptional

쿠폰번호

Example: C1001442
textDivobjNmstringOptional

텍스트구분자명

Example: 텍스트구분자명
bnrImgPathNmstringOptional

배너이미지경로명

Example: /이미지경로명
bnrImgFileNmstringOptional

배너이미지파일명

Example: 이미지파일명
cpnBnrImgPathNmstringOptional

쿠폰배너이미지경로명

Example: /쿠폰이미지경로명
bnrImgAltContstringOptional

쿠폰배너이미지대체텍스트

Example: 쿠폰이미지대체텍스트
cpnBnrImgFileNmstringOptional

쿠폰배너이미지파일명

Example: 쿠폰이미지파일명
htmlFileContstringOptional

HTML파일내용

Example: HTML내용
stateFormstringOptional

구분자상태

Example: I
get/v1/display/marketingDisplayMgmt/getMarketingDisplayDivobjGridList
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"
}

기획전 등록/수정 팝업 상품정보 탭 - 기획전 상품정보 상세 조회

get

기능설명

  • 상품정보 탭 - 기획전 구분자별 상품 상세정보를 조회하는 API 입니다.


상세설명

  • 기획전번호,구분자번호를 받아 구분자별 상품 상세 정보를 조회합니다.

  • 중복되는 상품이 있으면 해당 상품은 제외하고 상품들의 전시순서는 1부터 세팅해줍니다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
divobjNostringRequired

구분자번호

Example: 1
goodsArrayarrayRequired

상품번호Array

Responses
200

기획전 구분자별 상품 목록 조회 및 세팅 성공

*/*

기획전상품정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
goodsNostringOptional

상품번호

Example: 10002131
goodsNmstringOptional

상품명

Example: 상품명
dispSeqinteger · int32Optional

전시순서

Example: 1
saleStatCdstringOptional

판매상태코드

Example: 10
saleStatCdNmstringOptional

판매상태코드명

Example: 판매중
entrNostringOptional

협력사번호

Example: 1000002
entrNmstringOptional

협력사명

Example: 플래티어 협력사
norPrcnumberOptional

정상가

Example: 25000
salePrcnumberOptional

할인가

Example: 20000
errorMessagestringOptional

오류메시지

Example: 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.
validStatstringOptional

오류상태

timeDealYnstringOptional

타임딜적용여부

tmdlHistStrDtmstring · date-timeOptional

타임딜시작일시

tmdlHistEndDtmstring · date-timeOptional

타임딜종료일시

tmdlSalePrcnumberOptional

타임딜판매가

get/v1/display/marketingDisplayMgmt/getGoodsListDetail
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
}

기획전 등록/수정 팝업 상품정보 탭 - 기획전 구분자별 상품 그리드 목록 조회

get

기능설명

  • 상품정보 탭 - 기획전 구분자별 상품그리드 목록을 조회하는 API 입니다.


상세설명

  • 기획전번호,구분자번호를 받아 구분자별 상품 목록을 조회합니다.

  • 기획전 구분자별 상품 목록은 전시순서 오름차순, 상품등록날짜 오름차순으로 노출됩니다.


수정번호

Release v1.02_231023 : 스프린트2 PO1 결함/개선 Release v1.06_250609 : 타임딜 상품 추가 시 타임딜 관련 정보 조회

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired

기획전번호

Example: 14862
divobjNostringRequired

구분자번호

Example: 1
Responses
200

기획전 구분자별 상품 목록 조회 성공

*/*

기획전상품정보

langCdstringOptional

언어코드

Example: ko
mkdpNostringOptional

기획전번호

Example: 14862
divobjNostringOptional

구분자번호

Example: 1
goodsNostringOptional

상품번호

Example: 10002131
goodsNmstringOptional

상품명

Example: 상품명
dispSeqinteger · int32Optional

전시순서

Example: 1
saleStatCdstringOptional

판매상태코드

Example: 10
saleStatCdNmstringOptional

판매상태코드명

Example: 판매중
entrNostringOptional

협력사번호

Example: 1000002
entrNmstringOptional

협력사명

Example: 플래티어 협력사
norPrcnumberOptional

정상가

Example: 25000
salePrcnumberOptional

할인가

Example: 20000
errorMessagestringOptional

오류메시지

Example: 해당 상품번호는 존재하지 않는 상품번호이거나 묶음 상품입니다.
validStatstringOptional

오류상태

timeDealYnstringOptional

타임딜적용여부

tmdlHistStrDtmstring · date-timeOptional

타임딜시작일시

tmdlHistEndDtmstring · date-timeOptional

타임딜종료일시

tmdlSalePrcnumberOptional

타임딜판매가

get/v1/display/marketingDisplayMgmt/getDivobjGoodsGridList
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
}

기획전 구좌 → 구성안 변환(저장 전)

get

기능설명

구 편집기로 저작된 기획전의 구분자·상품·쿠폰을 구성안 문서로 옮겨 돌려준다. 저장하지 않는다 — 편집기에 띄울 문서를 만들 뿐이고, 전환은 저장할 때 확정된다.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
mkdpNostringRequired
Responses
200

OK

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadanyOptional

payload

errorbooleanOptional

is error

get/v1/display/marketingDisplayMgmt/convertPlanLayout
GET /api/bo/v1/display/marketingDisplayMgmt/convertPlanLayout?mkdpNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": null,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

마지막 업데이트