기획전 정보 관리

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

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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filesstring · binary[]Optional

Responses

200

기획전 구분자탭 저장 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

기획전 구분자탭 저장 실패

*/*

post

/v1/display/marketingDisplayMgmt/savePrMkdpDivobj

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
  "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filesstring · binary[]Optional

Responses

200

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

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

기획전 구분자정보 다국어 저장 실패

*/*

post

/v1/display/marketingDisplayMgmt/savePrMkdpDivobjMl

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
  "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filesstring · binary[]Optional

Responses

200

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

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

기획전 기본정보 탭 등록/수정 실패

*/*

post

/v1/display/marketingDisplayMgmt/savePrMkdpBase

HTTPcURLJavaScriptPython

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: 1893

{
  "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
      }
    ],
    "imgAltList": [
      {
        "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",
    "mbrDispGradeCd": [
      30,
      40
    ],
    "bnrImgPathNm": "text",
    "totalCount": 1,
    "fileIdx": 1,
    "dispStat": "text",
    "dispStatName": "text",
    "dispMediaNm": "text"
  }
}

{
  "timestamp": "2026-02-27T18:20:39.093Z",
  "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
      }
    ],
    "imgAltList": [
      {
        "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",
    "mbrDispGradeCd": [
      30,
      40
    ],
    "bnrImgPathNm": "text",
    "totalCount": 1,
    "fileIdx": 1,
    "dispStat": "text",
    "dispStatName": "text",
    "dispMediaNm": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Deprecated

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

post

기능설명

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

---

상세설명

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

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

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

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject[]

application/json

기획전상품정보

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

타임딜판매가

900

기획전 상품 엑셀 일괄 저장 실패

*/*

post

/v1/display/marketingDisplayMgmt/saveMarketingMgmtExcelGoodsList

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
    "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
    "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-02-27T18:20:39.093Z",
  "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
  "tmdlSalePrc": 1
}

기획전 정보 관리 목록 저장

post

기능설명

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

---

상세설명

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

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

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

  • delete : mkdpNo *

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

기획전 목록 저장 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

기획전 목록 저장 실패

*/*

post

/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtList

HTTPcURLJavaScriptPython

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: 7482

{
  "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
        }
      ],
      "imgAltList": [
        {
          "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",
      "mbrDispGradeCd": [
        30,
        40
      ],
      "bnrImgPathNm": "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
        }
      ],
      "imgAltList": [
        {
          "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",
      "mbrDispGradeCd": [
        30,
        40
      ],
      "bnrImgPathNm": "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
        }
      ],
      "imgAltList": [
        {
          "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",
      "mbrDispGradeCd": [
        30,
        40
      ],
      "bnrImgPathNm": "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
        }
      ],
      "imgAltList": [
        {
          "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",
      "mbrDispGradeCd": [
        30,
        40
      ],
      "bnrImgPathNm": "text",
      "totalCount": 1,
      "fileIdx": 1,
      "dispStat": "text",
      "dispStatName": "text",
      "dispMediaNm": "text"
    }
  ]
}

{
  "timestamp": "2026-02-27T18:20:39.093Z",
  "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filesstring · binary[]Optional

Responses

200

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

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

기획전 기본정보 다국어 저장 실패

*/*

post

/v1/display/marketingDisplayMgmt/saveMarketingDisplayMgmtBaseMl

HTTPcURLJavaScriptPython

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: 1893

{
  "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
      }
    ],
    "imgAltList": [
      {
        "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",
    "mbrDispGradeCd": [
      30,
      40
    ],
    "bnrImgPathNm": "text",
    "totalCount": 1,
    "fileIdx": 1,
    "dispStat": "text",
    "dispStatName": "text",
    "dispMediaNm": "text"
  }
}

{
  "timestamp": "2026-02-27T18:20:39.093Z",
  "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
      }
    ],
    "imgAltList": [
      {
        "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",
    "mbrDispGradeCd": [
      30,
      40
    ],
    "bnrImgPathNm": "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

기획전 상품 정보 저장 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

기획전 상품 정보 저장 실패

*/*

post

/v1/display/marketingDisplayMgmt/saveDivobjGoodsGridList

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
      "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
      "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-02-27T18:20:39.093Z",
      "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
      "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-02-27T18:20:39.093Z",
      "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
      "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-02-27T18:20:39.093Z",
      "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
      "tmdlSalePrc": 1
    }
  ]
}

{
  "timestamp": "2026-02-27T18:20:39.093Z",
  "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

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject[]

application/json

기획전상품정보

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

타임딜판매가

900

기획전 상품 엑셀 일괄 저장 실패

*/*

post

/v1/display/marketingDisplayMgmt/saveBulkDivobjGoodsUpload

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
    "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
    "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-02-27T18:20:39.093Z",
  "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
  "tmdlSalePrc": 1
}

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

post

기능설명

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

---

상세설명

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

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

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

  • 필요 값 : mkdpNo *

---

수정번호

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

기획전기본

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

mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]

bnrImgPathNmstringOptional

배너이미지경로명

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

900

기획전 복사 실패

*/*

post

/v1/display/marketingDisplayMgmt/registerCopyMarketingDisplayMgmt

HTTPcURLJavaScriptPython

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: 1859

{
  "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
    }
  ],
  "imgAltList": [
    {
      "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",
  "mbrDispGradeCd": [
    30,
    40
  ],
  "bnrImgPathNm": "text",
  "totalCount": 1,
  "fileIdx": 1,
  "dispStat": "text",
  "dispStatName": "text",
  "dispMediaNm": "text"
}

{
  "timestamp": "2026-02-27T18:20:39.093Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Deprecated

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

post

기능설명

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

---

상세설명

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

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

---

특이사항 (에러메시지)

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

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

mkdpNostringRequired

기획전번호

Example: 14862

divobjNostringRequired

구분자번호

Example: 1

goodsInfoListListRequired

상품정보리스트

Body

application/json

기획전상품정보 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

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
      "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
      "tmdlSalePrc": 1
    }
  ]
}

200

OK

{
  "timestamp": "2026-02-27T18:20:39.093Z",
  "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-02-27T18:20:39.093Z",
      "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
      "tmdlSalePrc": 1
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

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

get

기능설명

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

---

상세설명

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

Authorizations

accessToken

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

900

기획전 구분자 다국어정보 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getPrMkdpDivobjMultiLanguage

HTTPcURLJavaScriptPython

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

accessToken

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

mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]

bnrImgPathNmstringOptional

배너이미지경로명

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional

dispStatNamestringOptional

dispMediaNmstringOptional

900

기획전 기본정보 다국어 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getPrMkdpBaseMultiLanguage

HTTPcURLJavaScriptPython

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
    }
  ],
  "imgAltList": [
    {
      "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",
  "mbrDispGradeCd": [
    30,
    40
  ],
  "bnrImgPathNm": "text",
  "totalCount": 1,
  "fileIdx": 1,
  "dispStat": "text",
  "dispStatName": "text",
  "dispMediaNm": "text"
}

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

get

기능설명

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

---

상세설명

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

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

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

Authorizations

accessToken

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

mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]

bnrImgPathNmstringOptional

배너이미지경로명

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional

dispStatNamestringOptional

dispMediaNmstringOptional

900

기획전 정보 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getPrMkdpBaseList

HTTPcURLJavaScriptPython

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
    }
  ],
  "imgAltList": [
    {
      "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",
  "mbrDispGradeCd": [
    30,
    40
  ],
  "bnrImgPathNm": "text",
  "totalCount": 1,
  "fileIdx": 1,
  "dispStat": "text",
  "dispStatName": "text",
  "dispMediaNm": "text"
}

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

get

기능설명

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

---

상세설명

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

---

수정번호

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

Authorizations

accessToken

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

mbrDispGradeCdstring[]Optional

전시회원코드 배열

Example: [30,40]

bnrImgPathNmstringOptional

배너이미지경로명

totalCountinteger · int32Optional

전체개수

fileIdxinteger · int32Optional

업로드파일 순번

dispStatstringOptional

dispStatNamestringOptional

dispMediaNmstringOptional

900

기획전 상세정보 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getPrMkdpBaseDetail

HTTPcURLJavaScriptPython

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
    }
  ],
  "imgAltList": [
    {
      "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",
  "mbrDispGradeCd": [
    30,
    40
  ],
  "bnrImgPathNm": "text",
  "totalCount": 1,
  "fileIdx": 1,
  "dispStat": "text",
  "dispStatName": "text",
  "dispMediaNm": "text"
}

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

get

기능설명

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

---

상세설명

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

Authorizations

accessToken

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

이미지업로드 순번

900

기획전 상세 이미지 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getPrDispImgInfoDetail

HTTPcURLJavaScriptPython

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

기능설명

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

---

상세설명

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

Authorizations

accessToken

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

900

기획전 구분자정보 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getMarketingDisplayMgmtDivobj

HTTPcURLJavaScriptPython

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

accessToken

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

900

기획전 구분자정보 목록 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getMarketingDisplayDivobjGridList

HTTPcURLJavaScriptPython

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

accessToken

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

타임딜판매가

900

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

*/*

get

/v1/display/marketingDisplayMgmt/getGoodsListDetail

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
  "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
  "tmdlSalePrc": 1
}

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

get

기능설명

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

---

상세설명

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

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

---

수정번호

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

Authorizations

accessToken

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

타임딜판매가

900

기획전 구분자별 상품 목록 조회 실패

*/*

get

/v1/display/marketingDisplayMgmt/getDivobjGoodsGridList

HTTPcURLJavaScriptPython

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-02-27T18:20:39.093Z",
  "tmdlHistEndDtm": "2026-02-27T18:20:39.093Z",
  "tmdlSalePrc": 1
}