> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front/goods/undefined-4.md).

# 상품문의

회원이 작성한 상품 Q\&A를 조회하고, 상품 상세 화면 및 마이페이지에 노출하는 기능을 제공합니다. 또한, 상품 Q\&A 작성, 수정, 삭제, 답변 목록 조회 등 다양한 기능을 제공하여 원활한 서비스를 지원합니다.

***

## 주요 기능

* **상품 Q\&A 조회**
  * 상품 Q\&A 조회시 상품 Q\&A 번호, 회원번호, 상품번호 중 하나를 이용하여 조회.
  * 상품 Q\&A 조회시 회원정보와 조회조건 시작/종료일 사이의 상품 Q\&A를 조회.
  * 별도 조회조건 미설정시 최근 1주일 이내 작성된 상품 Q\&A의 목록을 조회.
  * 상품 Q\&A 날짜 목록은 최근 수정 순으로 노출됨.
* **상품 Q\&A 등록**
  * 상품 Q\&A 작성 화면에서 상품 Q\&A 작성 후 등록시 호출 됨.
  * 상품번호를 파라미터로 받아 해당 상품의 상품 Q\&A로 등록.
* **상품 Q\&A 수정/삭제**
  * 상품 Q\&A 수정을 위해 기존 작성된 상품 Q\&A 정보를 상품 Q\&A 번호를 통해 조회.
  * 회원정보를 확인하여 회원 본인이 작성한 상품 Q\&A만 수정 및 삭제 기능.
* **상품 Q\&A 답변 목록 조회**
  * 상품 Q\&A 질문 정보를 파라미터로 받아 단일 상품 Q\&A의 상품 답변 목록을 조회합니다. 상품 Q\&A 상세내용 하단에 노출됨.

## 프로세스 정의

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FyxlK1128YmEGzmPtynD4%2F183107758.jpg?alt=media&amp;token=c913b082-cc7b-4bb7-bfe5-fabea60dd9e4" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 상품별 Q\&A 정보 조회

* 상품번호, 페이지사이즈, 페이지번호를 통해 상품별 Q\&A 목록을 조회합니다.
* 상품상세 페이지 진입시 상품상세 하단 상품 Q\&A 영역에 상품 Q\&A 노출을 위해 호출합니다.
  {% endstep %}

{% step %}

### 상품 Q\&A 등록

* 상품 Q\&A 작성 화면에서 상품 Q\&A 작성 후 등록시 호출됩니다.
* 상품번호를 파라미터로 받아 해당 상품의 상품 Q\&A로 등록합니다.
  {% endstep %}

{% step %}

### 상품 Q\&A 상세 내용 조회

* 상품 Q\&A 수정시 기존 작성된 상품 Q\&A정보를 불러오기 위해 호출합니다.
* 질문번호를 파라미터로 받아 단일 상품 Q\&A의 상세내용을 조회합니다.
  {% endstep %}

{% step %}

### 상품 Q\&A 수정

* 상품 Q\&A 목록 화면 또는 마이페이지의 상품 Q\&A 화면에서 상품 Q\&A 수정시 호출됩니다.
* 질문번호를 파라미터로 받아 해당 질문번호에 해당하는 상품 Q\&A를 수정합니다.
  {% endstep %}

{% step %}

### 상품 Q\&A 삭제

* 상품 Q\&A 목록 화면 또는 마이페이지 내 상품 Q\&A 화면에서 상품 Q\&A 삭제시 호출됩니다.
* 회원 본인이 작성한 상품 Q\&A만 삭제 가능하며, 질문번호를 파라미터로 받아 해당 질문번호에 해당하는 상품 Q\&A를 논리 삭제합니다.
  {% endstep %}

{% step %}

### 상품 Q\&A 답변 목록 조회

* 상품 Q\&A 질문 정보를 파라미터로 받아 단일 상품 Q\&A의 상품 답변 목록을 조회합니다.
  {% endstep %}

{% step %}

### 회원 상품별 Q\&A 건수 조회

* 마이페이지의 활동 현황에 회원의 상품 Q\&A등록건수를 노출하기 위해 호출됩니다.
* 회원 모듈에 제공되는 API이며, 회원 정보가 필수값입니다.
  {% endstep %}
  {% endstepper %}

## API 기능 목록

<table><thead><tr><th width="108.111083984375">API</th><th width="384.5556640625">설명</th><th width="93.5555419921875">Server</th><th width="93.5555419921875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>상품 Q&#x26;A 상세내용 조회</td><td><ul><li>상품Q&#x26;A 수정시 기존 상품Q&#x26;A 정보를 <br>불러오기 위해 호출합니다.</li><li>질문번호를 파라미터로 받아 단일 상품Q&#x26;A의 상세내용을 조회합니다</li></ul></td><td>Goods</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EB%AC%B8%EC%9D%98&#x26;path=seltQnaDetail">🔗API 확인하기></a></td></tr><tr><td>상품 Q&#x26;A 답변 목록 조회</td><td><ul><li>상품 Q&#x26;A 질문 정보를 파라미터로 받아 단일 Q&#x26;A의 상품 답변 목록을 조회합니다.</li><li>질문 정보 request 내 질문번호는 필수값입니다.</li></ul></td><td>Goods</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EB%AC%B8%EC%9D%98&#x26;path=seltQnaAnsCmmtList">🔗API 확인하기></a></td></tr><tr><td>상품 Q&#x26;A 등록</td><td><ul><li>상품 Q&#x26;A 작성 화면에서 상품Q&#x26;A 작성 후 <br>등록시 호출됩니다.</li><li>상품번호를 파라미터로 받아서 해당 상품의 <br>상품 Q&#x26;A로등록합니다.</li></ul></td><td>Goods</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EB%AC%B8%EC%9D%98&#x26;path=insertQna">🔗API 확인하기></a></td></tr><tr><td>상품 Q&#x26;A 삭제</td><td><ul><li>상품 Q&#x26;A 목록 화면 또는 마이페이지의 상품 Q&#x26;A 화면에서 상품 Q&#x26;A 삭제시 호출됩니다.</li><li>질문번호를 파라미터로 받아서 해당 질문번호에 해당하는상품 Q&#x26;A를 삭제합니다.</li></ul></td><td>Goods</td><td>DELETE</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EB%AC%B8%EC%9D%98&#x26;path=deleteQna">🔗API 확인하기></a></td></tr><tr><td>상품 Q&#x26;A 수정</td><td><ul><li>상품 Q&#x26;A 목록 화면 또는 마이페이지의 상품 Q&#x26;A 화면에서 상품 Q&#x26;A 수정시 호출됩니다.</li><li>질문번호를 파라미터로 받아서 해당 질문<br>번호에 해당하는 상품 Q&#x26;A를 수정합니다</li></ul></td><td>Goods</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EB%AC%B8%EC%9D%98&#x26;path=modifyQna_1">🔗API 확인하기></a></td></tr><tr><td>회원별 <br>상품 Q&#x26;A 등록건수 조회</td><td><ul><li>마이페이지의 활동 현황에 회원이 작성한 <br>상품 Q&#x26;A 건수를 보여주기 위해 호출됩니다.</li><li>회원 모듈에 제공되는 API이며, 회원 정보가 <br>필수값입니다.</li></ul></td><td>Member</td><td>POST</td><td>회원 모듈 제공 API<br><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EB%AC%B8%EC%9D%98&#x26;path=getUserQnaCount">🔗API 확인하기></a></td></tr></tbody></table>

##