상품 Q&A 관리

상품 Q&A 상세내용 조회

get

기능설명

• 상품 Q&A 상세내용을 조회합니다.

---

상세설명

• 상품Q&A 수정시 기존 상품Q&A 정보를 불러오기 위해 호출합니다.

• 질문번호를 파라미터로 받아 단일 상품Q&A의 상세내용을 조회합니다.

---

수정번호

Release v1.04_231120: 상품 Q&A

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

questNostringRequired

질문번호

Example: 11023494

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품 Q&A 상세내용 조회 성공

application/json

900

상품 Q&A 상세내용 조회 실패

application/json

get

/v1/qna/adv/{questNo}

HTTPcURLJavaScriptPython

GET /api/goods/v1/qna/adv/{questNo} HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goods": {
    "goodsNo": "text",
    "goodsNm": "text",
    "brandNm": "text",
    "contFilePathNm": "text",
    "entrNo": "text",
    "stdCtgNo": "text"
  },
  "question": {
    "questNo": 11023494,
    "goodsNo": 10002191,
    "mbrNo": 100000290,
    "loginId": "id079",
    "mbrStatCd": "text",
    "entrNo": 1000002,
    "questTypCd": 10,
    "questTitle": "상품 질문 드립니다.",
    "questCont": "상품 질문 내용입니다.",
    "questDtm": "2026-02-27T20:07:44.431Z",
    "procStatCd": 10,
    "procId": "text",
    "notiMethodCd": 20,
    "scrtScrpYn": "N",
    "kakaoSMScheck": "N",
    "cellSctNo": "010",
    "cellTxnoNo": 1111,
    "cellEndNo": "text",
    "questDispStatCd": 2222,
    "emailAddr": "[e-mail]",
    "delYn": "N",
    "contents": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contSn": 1
      }
    ],
    "answerList": [
      {
        "questNo": "text",
        "goodsNo": "text",
        "mbrNo": "text",
        "loginId": "text",
        "mbrStatCd": "text",
        "entrNo": "text",
        "questTypCd": "text",
        "questTitle": "text",
        "questCont": "text",
        "procStatCd": "text",
        "prodId": "text",
        "notiMethodCd": "text",
        "scrtScrpYn": "text",
        "kakaoSMScheck": "text",
        "cellSctNo": "text",
        "cellTxnoNo": "text",
        "cellEndNo": "text",
        "questDispStatCd": "text",
        "emailAddr": "text",
        "delYn": "text",
        "ansCont": "text",
        "contents": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contSn": 1
          }
        ]
      }
    ],
    "deleteGoodsQnaContList": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contSn": 1
      }
    ]
  },
  "questionListData": {
    "data": [
      {
        "questNo": 11023494,
        "goodsNo": 10002191,
        "mbrNo": 100000290,
        "loginId": "id079",
        "mbrStatCd": "text",
        "entrNo": 1000002,
        "questTypCd": 10,
        "questTitle": "상품 질문 드립니다.",
        "questCont": "상품 질문 내용입니다.",
        "questDtm": "2026-02-27T20:07:44.431Z",
        "procStatCd": 10,
        "procId": "text",
        "notiMethodCd": 20,
        "scrtScrpYn": "N",
        "kakaoSMScheck": "N",
        "cellSctNo": "010",
        "cellTxnoNo": 1111,
        "cellEndNo": "text",
        "questDispStatCd": 2222,
        "emailAddr": "[e-mail]",
        "delYn": "N",
        "contents": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contSn": 1
          }
        ],
        "answerList": [
          {
            "questNo": "text",
            "goodsNo": "text",
            "mbrNo": "text",
            "loginId": "text",
            "mbrStatCd": "text",
            "entrNo": "text",
            "questTypCd": "text",
            "questTitle": "text",
            "questCont": "text",
            "procStatCd": "text",
            "prodId": "text",
            "notiMethodCd": "text",
            "scrtScrpYn": "text",
            "kakaoSMScheck": "text",
            "cellSctNo": "text",
            "cellTxnoNo": "text",
            "cellEndNo": "text",
            "questDispStatCd": "text",
            "emailAddr": "text",
            "delYn": "text",
            "ansCont": "text",
            "contents": [
              {
                "questNo": 11023494,
                "contFilePathNm": "/file/content.jpg",
                "contSn": 1
              }
            ]
          }
        ],
        "deleteGoodsQnaContList": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contSn": 1
          }
        ]
      }
    ],
    "totalCnt": 1
  },
  "questionList": [
    {
      "questNo": 11023494,
      "goodsNo": 10002191,
      "mbrNo": 100000290,
      "loginId": "id079",
      "mbrStatCd": "text",
      "entrNo": 1000002,
      "questTypCd": 10,
      "questTitle": "상품 질문 드립니다.",
      "questCont": "상품 질문 내용입니다.",
      "questDtm": "2026-02-27T20:07:44.431Z",
      "procStatCd": 10,
      "procId": "text",
      "notiMethodCd": 20,
      "scrtScrpYn": "N",
      "kakaoSMScheck": "N",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": "text",
      "questDispStatCd": 2222,
      "emailAddr": "[e-mail]",
      "delYn": "N",
      "contents": [
        {
          "questNo": 11023494,
          "contFilePathNm": "/file/content.jpg",
          "contSn": 1
        }
      ],
      "answerList": [
        {
          "questNo": "text",
          "goodsNo": "text",
          "mbrNo": "text",
          "loginId": "text",
          "mbrStatCd": "text",
          "entrNo": "text",
          "questTypCd": "text",
          "questTitle": "text",
          "questCont": "text",
          "procStatCd": "text",
          "prodId": "text",
          "notiMethodCd": "text",
          "scrtScrpYn": "text",
          "kakaoSMScheck": "text",
          "cellSctNo": "text",
          "cellTxnoNo": "text",
          "cellEndNo": "text",
          "questDispStatCd": "text",
          "emailAddr": "text",
          "delYn": "text",
          "ansCont": "text",
          "contents": [
            {
              "questNo": 11023494,
              "contFilePathNm": "/file/content.jpg",
              "contSn": 1
            }
          ]
        }
      ],
      "deleteGoodsQnaContList": [
        {
          "questNo": 11023494,
          "contFilePathNm": "/file/content.jpg",
          "contSn": 1
        }
      ]
    }
  ]
}

상품 Q&A 수정

put

기능설명

• 작성한 상품 Q&A를 수정합니다.

---

상세설명

• 상품 Q&A 목록 화면 또는 마이페이지의 상품 Q&A 화면에서 상품 Q&A 수정시 호출됩니다.

• 질문번호를 파라미터로 받아서 해당 질문번호에 해당하는 상품 Q&A를 수정합니다.

• 회원정보를 확인하여 본인이 작성한 상품 Q&A만 수정이 가능합니다.

---

수정번호

Release v1.04_231120: 상품 Q&A 수정 API 개선

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

questNostringRequired

상품 Q&A 번호

Example: 11023494

Query parameters

filesstring · binaryRequired

멀티미디어 정보

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

Responses

200

상품 Q&A 수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadanyOptional

payload

errorbooleanOptional

is error

900

상품 Q&A 수정 실패

*/*

put

/v1/qna/adv/{questNo}

HTTPcURLJavaScriptPython

PUT /api/goods/v1/qna/adv/{questNo}?files=binary HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1227

{
  "question": {
    "questNo": 11023494,
    "goodsNo": 10002191,
    "mbrNo": 100000290,
    "loginId": "id079",
    "mbrStatCd": "text",
    "entrNo": 1000002,
    "questTypCd": 10,
    "questTitle": "상품 질문 드립니다.",
    "questCont": "상품 질문 내용입니다.",
    "questDtm": "2026-02-27T20:07:44.431Z",
    "procStatCd": 10,
    "procId": "text",
    "notiMethodCd": 20,
    "scrtScrpYn": "N",
    "kakaoSMScheck": "N",
    "cellSctNo": "010",
    "cellTxnoNo": 1111,
    "cellEndNo": "text",
    "questDispStatCd": 2222,
    "emailAddr": "[e-mail]",
    "delYn": "N",
    "contents": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contFileNm": "content.jpg",
        "contSn": 1
      }
    ],
    "answerList": [
      {
        "questNo": "text",
        "goodsNo": "text",
        "mbrNo": "text",
        "loginId": "text",
        "mbrStatCd": "text",
        "entrNo": "text",
        "questTypCd": "text",
        "questTitle": "text",
        "questCont": "text",
        "procStatCd": "text",
        "prodId": "text",
        "notiMethodCd": "text",
        "scrtScrpYn": "text",
        "kakaoSMScheck": "text",
        "cellSctNo": "text",
        "cellTxnoNo": "text",
        "cellEndNo": "text",
        "questDispStatCd": "text",
        "emailAddr": "text",
        "delYn": "text",
        "ansCont": "text",
        "contents": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contFileNm": "content.jpg",
            "contSn": 1
          }
        ]
      }
    ],
    "deleteGoodsQnaContList": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contFileNm": "content.jpg",
        "contSn": 1
      }
    ]
  }
}

{
  "timestamp": "2026-02-27T20:07:44.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": null,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상품 Q&A 삭제

delete

기능설명

• 상품 Q&A를 삭제합니다.

---

상세설명

• 상품 Q&A 목록 화면 또는 마이페이지의 상품 Q&A 화면에서 상품 Q&A 삭제시 호출됩니다.

• 질문번호를 파라미터로 받아서 해당 질문번호에 해당하는 상품 Q&A를 삭제합니다.

• 회원정보를 확인하여 본인이 작성한 상품 Q&A만 삭제가 가능합니다.

• 상품 Q&A를 물리적으로 삭제하지 않고 삭제 여부만 'Y'로 변경하여 화면에 노출되지 않게합니다.

---

수정번호

Release v1.04_231120: 상품 Q&A 수정 API 개선

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

questNostringRequired

string

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품 Q&A 삭제 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadanyOptional

payload

errorbooleanOptional

is error

900

상품 Q&A 삭제 실패

*/*

delete

/v1/qna/adv/{questNo}

HTTPcURLJavaScriptPython

DELETE /api/goods/v1/qna/adv/{questNo} HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T20:07:44.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": null,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상품QnA 등록

post

기능설명

• 상품 Q&A를 등록합니다.

---

상세설명

• 상품 Q&A 작성 화면에서 상품Q&A 작성 후 등록시 호출됩니다.

• 상품 Q&A를 등록합니다.

---

수정번호

Release v1.04_231120: 상품 Q&A 등록 API 개선

Release v2.00_240409: 맵핑 주소에서 /제거.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filesstring · binaryRequired

멀티미디어 정보

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

Responses

200

상품 Q&A 등록 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadanyOptional

payload

errorbooleanOptional

is error

900

상품 Q&A 등록 실패

*/*

post

/v1/qna/adv

HTTPcURLJavaScriptPython

POST /api/goods/v1/qna/adv?files=binary HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1227

{
  "question": {
    "questNo": 11023494,
    "goodsNo": 10002191,
    "mbrNo": 100000290,
    "loginId": "id079",
    "mbrStatCd": "text",
    "entrNo": 1000002,
    "questTypCd": 10,
    "questTitle": "상품 질문 드립니다.",
    "questCont": "상품 질문 내용입니다.",
    "questDtm": "2026-02-27T20:07:44.431Z",
    "procStatCd": 10,
    "procId": "text",
    "notiMethodCd": 20,
    "scrtScrpYn": "N",
    "kakaoSMScheck": "N",
    "cellSctNo": "010",
    "cellTxnoNo": 1111,
    "cellEndNo": "text",
    "questDispStatCd": 2222,
    "emailAddr": "[e-mail]",
    "delYn": "N",
    "contents": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contFileNm": "content.jpg",
        "contSn": 1
      }
    ],
    "answerList": [
      {
        "questNo": "text",
        "goodsNo": "text",
        "mbrNo": "text",
        "loginId": "text",
        "mbrStatCd": "text",
        "entrNo": "text",
        "questTypCd": "text",
        "questTitle": "text",
        "questCont": "text",
        "procStatCd": "text",
        "prodId": "text",
        "notiMethodCd": "text",
        "scrtScrpYn": "text",
        "kakaoSMScheck": "text",
        "cellSctNo": "text",
        "cellTxnoNo": "text",
        "cellEndNo": "text",
        "questDispStatCd": "text",
        "emailAddr": "text",
        "delYn": "text",
        "ansCont": "text",
        "contents": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contFileNm": "content.jpg",
            "contSn": 1
          }
        ]
      }
    ],
    "deleteGoodsQnaContList": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contFileNm": "content.jpg",
        "contSn": 1
      }
    ]
  }
}

{
  "timestamp": "2026-02-27T20:07:44.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": null,
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상품 Q&A 목록 조회 (통합검색)

get

기능설명

• 상품 Q&A 목록을 조회합니다.

---

상세설명

• 마이페이지 활동현황에서 상품 Q&A 페이지에 진입시 해당 회원이 작성한 상품 Q&A 목록 조회를 위해 호출합니다.

• 조회조건 시작일과 종료일 사이 작성한 상품 Q&A 목록을 조회합니다.

• 별도 조회조건 미설정시 최근 1주일 내 작성된 상품 Q&A 목록을 조회합니다.

---

수정번호

Release v1.04_231120: 상품 Q&A

Release v2.00_240409: 질문글 및 답변글의 questCont 값 XSS 필터처리.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageSizestringOptional

integer

Example: 10

pageNostringOptional

integer

Example: 1

searchStartDatestringOptional

localDateTime

Example: 20231108

searchEndDatestringOptional

localDateTime

Example: 20231115

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품 Q&A 목록 조회 성공

application/json

totalCntinteger · int64Optional

900

상품 Q&A 목록 조회 실패

application/json

get

/v1/qna/adv/member

HTTPcURLJavaScriptPython

GET /api/goods/v1/qna/adv/member HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [],
  "totalCnt": 1
}

상품별 Q&A정보 조회

get

기능설명

• 상품별 Q&A 정보 목록을 조회합니다.

---

상세설명

• 상품번호를 통해 상품별 Q&A 정보 목록을 조회합니다.

• 상품상세 페이지 진입시 상품상세 하단 상품 Q&A 영역을 위해 호출합니다.

---

수정번호

Release v1.04_231120: 상품 Q&A

Release v2.00_240409: 본인이 작성한 비공개 질문이 아닌경우 답글 정보 제거. 질문글 및 답변글의 questCont 값 XSS 필터처리.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

goodsNostringRequired

string

Example: 10002031

Query parameters

pageSizestringOptional

integer

Example: 5

pageNostringOptional

integer

Example: 1

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

상품별 상품 Q&A 정보 조회 성공

application/json

900

상품별 상품 Q&A 정보 조회 실패

application/json

get

/v1/qna/adv/goods/{goodsNo}

HTTPcURLJavaScriptPython

GET /api/goods/v1/qna/adv/goods/{goodsNo} HTTP/1.1
Host: localhost:8093/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goods": {
    "goodsNo": "text",
    "goodsNm": "text",
    "brandNm": "text",
    "contFilePathNm": "text",
    "entrNo": "text",
    "stdCtgNo": "text"
  },
  "question": {
    "questNo": 11023494,
    "goodsNo": 10002191,
    "mbrNo": 100000290,
    "loginId": "id079",
    "mbrStatCd": "text",
    "entrNo": 1000002,
    "questTypCd": 10,
    "questTitle": "상품 질문 드립니다.",
    "questCont": "상품 질문 내용입니다.",
    "questDtm": "2026-02-27T20:07:44.431Z",
    "procStatCd": 10,
    "procId": "text",
    "notiMethodCd": 20,
    "scrtScrpYn": "N",
    "kakaoSMScheck": "N",
    "cellSctNo": "010",
    "cellTxnoNo": 1111,
    "cellEndNo": "text",
    "questDispStatCd": 2222,
    "emailAddr": "[e-mail]",
    "delYn": "N",
    "contents": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contSn": 1
      }
    ],
    "answerList": [
      {
        "questNo": "text",
        "goodsNo": "text",
        "mbrNo": "text",
        "loginId": "text",
        "mbrStatCd": "text",
        "entrNo": "text",
        "questTypCd": "text",
        "questTitle": "text",
        "questCont": "text",
        "procStatCd": "text",
        "prodId": "text",
        "notiMethodCd": "text",
        "scrtScrpYn": "text",
        "kakaoSMScheck": "text",
        "cellSctNo": "text",
        "cellTxnoNo": "text",
        "cellEndNo": "text",
        "questDispStatCd": "text",
        "emailAddr": "text",
        "delYn": "text",
        "ansCont": "text",
        "contents": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contSn": 1
          }
        ]
      }
    ],
    "deleteGoodsQnaContList": [
      {
        "questNo": 11023494,
        "contFilePathNm": "/file/content.jpg",
        "contSn": 1
      }
    ]
  },
  "questionListData": {
    "data": [
      {
        "questNo": 11023494,
        "goodsNo": 10002191,
        "mbrNo": 100000290,
        "loginId": "id079",
        "mbrStatCd": "text",
        "entrNo": 1000002,
        "questTypCd": 10,
        "questTitle": "상품 질문 드립니다.",
        "questCont": "상품 질문 내용입니다.",
        "questDtm": "2026-02-27T20:07:44.431Z",
        "procStatCd": 10,
        "procId": "text",
        "notiMethodCd": 20,
        "scrtScrpYn": "N",
        "kakaoSMScheck": "N",
        "cellSctNo": "010",
        "cellTxnoNo": 1111,
        "cellEndNo": "text",
        "questDispStatCd": 2222,
        "emailAddr": "[e-mail]",
        "delYn": "N",
        "contents": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contSn": 1
          }
        ],
        "answerList": [
          {
            "questNo": "text",
            "goodsNo": "text",
            "mbrNo": "text",
            "loginId": "text",
            "mbrStatCd": "text",
            "entrNo": "text",
            "questTypCd": "text",
            "questTitle": "text",
            "questCont": "text",
            "procStatCd": "text",
            "prodId": "text",
            "notiMethodCd": "text",
            "scrtScrpYn": "text",
            "kakaoSMScheck": "text",
            "cellSctNo": "text",
            "cellTxnoNo": "text",
            "cellEndNo": "text",
            "questDispStatCd": "text",
            "emailAddr": "text",
            "delYn": "text",
            "ansCont": "text",
            "contents": [
              {
                "questNo": 11023494,
                "contFilePathNm": "/file/content.jpg",
                "contSn": 1
              }
            ]
          }
        ],
        "deleteGoodsQnaContList": [
          {
            "questNo": 11023494,
            "contFilePathNm": "/file/content.jpg",
            "contSn": 1
          }
        ]
      }
    ],
    "totalCnt": 1
  },
  "questionList": [
    {
      "questNo": 11023494,
      "goodsNo": 10002191,
      "mbrNo": 100000290,
      "loginId": "id079",
      "mbrStatCd": "text",
      "entrNo": 1000002,
      "questTypCd": 10,
      "questTitle": "상품 질문 드립니다.",
      "questCont": "상품 질문 내용입니다.",
      "questDtm": "2026-02-27T20:07:44.431Z",
      "procStatCd": 10,
      "procId": "text",
      "notiMethodCd": 20,
      "scrtScrpYn": "N",
      "kakaoSMScheck": "N",
      "cellSctNo": "010",
      "cellTxnoNo": 1111,
      "cellEndNo": "text",
      "questDispStatCd": 2222,
      "emailAddr": "[e-mail]",
      "delYn": "N",
      "contents": [
        {
          "questNo": 11023494,
          "contFilePathNm": "/file/content.jpg",
          "contSn": 1
        }
      ],
      "answerList": [
        {
          "questNo": "text",
          "goodsNo": "text",
          "mbrNo": "text",
          "loginId": "text",
          "mbrStatCd": "text",
          "entrNo": "text",
          "questTypCd": "text",
          "questTitle": "text",
          "questCont": "text",
          "procStatCd": "text",
          "prodId": "text",
          "notiMethodCd": "text",
          "scrtScrpYn": "text",
          "kakaoSMScheck": "text",
          "cellSctNo": "text",
          "cellTxnoNo": "text",
          "cellEndNo": "text",
          "questDispStatCd": "text",
          "emailAddr": "text",
          "delYn": "text",
          "ansCont": "text",
          "contents": [
            {
              "questNo": 11023494,
              "contFilePathNm": "/file/content.jpg",
              "contSn": 1
            }
          ]
        }
      ],
      "deleteGoodsQnaContList": [
        {
          "questNo": 11023494,
          "contFilePathNm": "/file/content.jpg",
          "contSn": 1
        }
      ]
    }
  ]
}