아이콘 관리

아이콘 정보 등록 및 수정

post

기능설명

• 아이콘 정보를 등록 및 수정하는 API 입니다.

---

상세설명

• PC일 경우 MO 이미지경로 빈값, MO 일경우 PC이미지 빈값, 공통일 경우 PC,MO 이미지 경로를 저장합니다.

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

  • create : siteNo *, iconNm *, useYn *, dispMediaCd *, iconTypCd *, pcIconPathNm, pcIconFileNm, moIconPathNm, moIconFileNm

  • update : dispIconNo *, siteNo *, iconNm *, useYn *, dispMediaCd *, iconTypCd *, pcIconPathNm, pcIconFileNm, moIconPathNm, moIconFileNm

---

수정번호

• Release v1.03_231106 : 아이콘(뱃지) 설정

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filestring · binaryOptional

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/iconMgmt/saveIconInfoDetail

HTTPcURLJavaScriptPython

POST /api/bo/v1/display/iconMgmt/saveIconInfoDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 343

{
  "file": "binary",
  "prDispIconInfo": {
    "siteNo": 1,
    "dispIconNo": 120,
    "siteNm": "플래티어",
    "iconNm": "아이콘명",
    "useYn": "Y",
    "dispMediaCd": 10,
    "dispMediaCdNm": "PC",
    "iconTypCd": 100,
    "iconTypCdNm": "상품",
    "iconPathNm": "/icon",
    "pcIconPathNm": "pcTitle",
    "pcIconFileNm": "/pc",
    "moIconPathNm": "moTitle",
    "moIconFileNm": "/mo",
    "commonIconPathNm": "/common"
  }
}

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

아이콘 기본정보 조회

get

기능설명

• 아이콘 기본정보를 조회하는 API 입니다.

---

상세설명

• 아이콘 기본정보를 조회합니다.

---

수정번호

• Release v1.03_231106 : 아이콘(뱃지) 설정

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

dispIconNostringRequired

string

Example: 120

Responses

200

아이콘 기본정보 조회 성공

*/*

siteNostringOptional

사이트번호

Example: 1

dispIconNostringOptional

전시아이콘번호

Example: 120

siteNmstringOptional

사이트명

Example: 플래티어

iconNmstringOptional

아이콘명

Example: 아이콘명

useYnstringOptional

사용여부

Example: Y

dispMediaCdstringOptional

전시매체코드

Example: 10

dispMediaCdNmstringOptional

전시매체코드명

Example: PC

iconTypCdstringOptional

아이콘유형코드

Example: 100

iconTypCdNmstringOptional

아이콘유형코드명

Example: 상품

iconPathNmstringOptional

아이콘유형코드명

Example: /icon

pcIconPathNmstringOptional

PC아이콘경로명

Example: pcTitle

pcIconFileNmstringOptional

PC아이콘파일명

Example: /pc

moIconPathNmstringOptional

MO아이콘경로명

Example: moTitle

moIconFileNmstringOptional

MO아이콘경로명

Example: /mo

commonIconPathNmstringOptional

공통아이콘경로명

Example: /common

900

아이콘 기본정보 조회 실패

*/*

get

/v1/display/iconMgmt/getIconInfoDetail

HTTPcURLJavaScriptPython

GET /api/bo/v1/display/iconMgmt/getIconInfoDetail?dispIconNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "siteNo": 1,
  "dispIconNo": 120,
  "siteNm": "플래티어",
  "iconNm": "아이콘명",
  "useYn": "Y",
  "dispMediaCd": 10,
  "dispMediaCdNm": "PC",
  "iconTypCd": 100,
  "iconTypCdNm": "상품",
  "iconPathNm": "/icon",
  "pcIconPathNm": "pcTitle",
  "pcIconFileNm": "/pc",
  "moIconPathNm": "moTitle",
  "moIconFileNm": "/mo",
  "commonIconPathNm": "/common"
}

아이콘 목록 조회

get

기능설명

• 아이콘 목록을 조회하는 API 입니다.

---

상세설명

• 아이콘 목록을 조회합니다.

• 아이콘 목록은 아이콘번호 오름차순으로 노출됩니다.

---

수정번호

• Release v1.05_231204 : 스프린트5 PO1 결함/개선 - 아이콘 이미지 쿼리 수정

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

siteNostringOptional

string

Example: 1

dispIconNostringOptional

string

Example: 120

iconNmstringOptional

string

Example: 아이콘명

useYnstringOptional

string

Example: Y

pageIdxstringRequired

integer

Example: 1

rowsPerPagestringRequired

integer

Example: 100

Responses

200

아이콘 목록 조회 성공

*/*

siteNostringOptional

사이트번호

Example: 1

dispIconNostringOptional

전시아이콘번호

Example: 120

siteNmstringOptional

사이트명

Example: 플래티어

iconNmstringOptional

아이콘명

Example: 아이콘명

useYnstringOptional

사용여부

Example: Y

dispMediaCdstringOptional

전시매체코드

Example: 10

dispMediaCdNmstringOptional

전시매체코드명

Example: PC

iconTypCdstringOptional

아이콘유형코드

Example: 100

iconTypCdNmstringOptional

아이콘유형코드명

Example: 상품

iconPathNmstringOptional

아이콘유형코드명

Example: /icon

pcIconPathNmstringOptional

PC아이콘경로명

Example: pcTitle

pcIconFileNmstringOptional

PC아이콘파일명

Example: /pc

moIconPathNmstringOptional

MO아이콘경로명

Example: moTitle

moIconFileNmstringOptional

MO아이콘경로명

Example: /mo

commonIconPathNmstringOptional

공통아이콘경로명

Example: /common

900

아이콘 목록 조회 실패

*/*

get

/v1/display/iconMgmt/getIconBaseList

HTTPcURLJavaScriptPython

GET /api/bo/v1/display/iconMgmt/getIconBaseList?pageIdx=text&rowsPerPage=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "siteNo": 1,
  "dispIconNo": 120,
  "siteNm": "플래티어",
  "iconNm": "아이콘명",
  "useYn": "Y",
  "dispMediaCd": 10,
  "dispMediaCdNm": "PC",
  "iconTypCd": 100,
  "iconTypCdNm": "상품",
  "iconPathNm": "/icon",
  "pcIconPathNm": "pcTitle",
  "pcIconFileNm": "/pc",
  "moIconPathNm": "moTitle",
  "moIconFileNm": "/mo",
  "commonIconPathNm": "/common"
}