공지사항 FAQ

공지사항, FAQ 조회 수 증가

put

기능설명

• 공지사항, FAQ 조회 수를 증가합니다.

---

상세설명

• 선택한 공지사항, FAQ의 조회 수를 증가시킵니다.

---

코드정리

• 파라미터구분값(paramGubun) : NO:공지사항, FAQ:FAQ

Header parameters

AuthorizationanyOptional

Access Token

Body

공지사항, FAQ 조회 수 증가 요청 DTO

paramGubunstringOptional

파라미터구분값(NO:공지사항, FAQ:FAQ)

Example: FAQ

seqNostringOptional

조회수

Example: 1

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadobject · ReadCntResponseOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

put/v1/customerservice/questionReadCntSave

PUT /api/order/v1/customerservice/questionReadCntSave HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "paramGubun": "FAQ",
  "seqNo": "1"
}

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

공지사항 목록 조회

get

기능설명

• 고객센터 공지사항 목록을 조회한다.

---

상세설명

• 현재 전시중인 공지사항 목록을 조회합니다.

---

수정번호

• Release v2.00_240425: 멀티사이트 테이블 컬럼 추가(SITE_NO)로 인한 조회 쿼리 수정

Query parameters

dispMediaCdstringOptional

전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통

Example: 10

searchTextstringOptional

제목, 내용

Example: 고객공지사항

ntcClssCdstringOptional

공지분류코드(DP019)
10:일반공지, 20:이벤트공지

Example: 10

uprFixYnstringOptional

최상단여부체크

Example: N

ntcNostringOptional

공지번호

Example: 1000001

uprFixCntstringOptional

목록조회 시 상단고정글 갯수

Example: 5

pagingYnstringOptional

페이징처리여부

Example: Y

rowsPerPagestringOptional

화면당노출수량

Example: 10

pageIdxstringOptional

페이지번호

Example: 1

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get/v1/customerservice/notice

GET /api/order/v1/customerservice/notice HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "allPageCnt": 1,
    "curPageNo": 1,
    "allCnt": 1,
    "sysBbInfo": [
      {
        "ntcNo": "text",
        "ntcClssNm": "text",
        "ntcClssCd": "text",
        "uprFixYn": "text",
        "title": "text",
        "ntcCont": "text",
        "bbStrDtm": "text",
        "regDt": "text",
        "sortSeq": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

공지사항 상세 조회

get

기능설명

• 공지사항 상세내용을 조회한다.

---

상세설명

• 선택한 공지사항 상세내용을 조회합니다.

---

수정번호

• Release v2.00_240425: 멀티사이트 테이블 컬럼 추가(SITE_NO)로 인한 조회 쿼리 수정

Query parameters

dispMediaCdstringOptional

전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통

Example: 20

ntcNostringOptional

공지번호

Example: 1000171

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get/v1/customerservice/noticeDtl

GET /api/order/v1/customerservice/noticeDtl HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "allPageCnt": 1,
    "curPageNo": 1,
    "sysBbInfo": [
      {
        "ntcNo": "text",
        "ntcClssNm": "text",
        "ntcClssCd": "text",
        "uprFixYn": "text",
        "title": "text",
        "ntcCont": "text",
        "bbStrDtm": "text",
        "regDt": "text",
        "sortSeq": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

FAQ 조회

get

기능설명

• FAQ 목록과 상세를 조회한다.

---

상세설명

• FAQ 목록과 상세 정보를 조회합니다.

---

수정번호

• Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가

Query parameters

dispMediaCdstringOptional

전시매체코드(DP018)
10:PC, 20:MOBILE, 99:공통

Example: 10

faqLgrpCdstringOptional

FAQ대분류코드(CM014)
20:주문배송, 30:결제환불, 40:교환반품, 60:쿠폰혜택, 70:상품문의, 80:사이트이용, 90:기타

Example: 20

searchTextstringOptional

제목+내용

Example: 상품문의

pagingYnstringOptional

페이징처리여부

Example: Y

rowsPerPagestringOptional

화면당노출수량

Example: 10

pageIdxstringOptional

페이지번호

Example: 1

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get/v1/customerservice/faqInit

GET /api/order/v1/customerservice/faqInit HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "allPageCnt": 1,
    "curPageNo": 1,
    "faqInfo": [
      {
        "faqNo": "text",
        "faqLgrpCd": "text",
        "faqLgrpNm": "text",
        "faqMgrpNm": "text",
        "uprFixYn": "text",
        "title": "text",
        "ntcCont": "text",
        "sortSeq": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}