마이페이지 화면_나의 게시글
이해하기
나의 게시글 메뉴에서는 쇼핑몰 내 회원이 작성한 게시글 목록을 제공합니다.
제공하는 목록은 아래와 같습니다.
- 1:1 문의
- 쇼핑몰에 대한 문의를 등록한 것이며, 1:1문의는 등록자와 운영자만 확인할 수 있습니다. - 상품문의
- 상품에 대한 문의를 등록한 것이며, 공개여부에 따라 상품 상세에도 노출되어 다른 쇼핑몰 이용자도 확인 가능합니다. - 상품후기
- 구매한 상품의 후기를 작성할 수 있습니다. 작성한 후기는 상품 상세의 후기 탭에 노출됩니다.

🅐 1:1 문의
1:1 문의는 [어드민 > 게시판 관리 > 게시판리스트] 설정에 따릅니다.
1:1 문의는 회원에게만 제공되며, 비회원에게는 제공하지 않습니다.
게시글은 비밀글로 모두 저장되어 등록자 자신과 운영자(어드민에서 게시글 확인)만 게시글 확인이 가능합니다.

1:1 문의 메뉴 접근 시 1:1 문의 목록을 조회합니다.
- get1:1문의 내역 조회
- /inquiries
1:1문의글 목록을 전체 검색합니다.
조회 시 해당 회원의 1:1 문의만 조회해야 하므로 요청 시 accessToken 값에 해당 회원의 엑세스 토큰값을 추가하여 조회 하셔야 합니다.
기본 스킨에서는 게시글 번호, 문의유형, 문의 정보(제목, 비밀글, 최신글 등), 문의일, 답변 상태 값을 노출하여 제공합니다.
등록된 1:1 문의 상세 내용은 아래의 API를 통해 호출 가능합니다.
- get1:1문의 상세 조회
- /inquiries/{inquiryNo}
문의 번호 기준으로 1:1문의 상세 내용을 조회합니다.
답변이 완료 되지 않은 문의 글에 대해서만 수정 및 삭제가 가능합니다.
수정/삭제 API는 하단 내용에서 확인하실 수 있습니다.


1:1 문의 리스트에서 제공하는 1:1문의하기 버튼을 통해 게시글 등록이 가능합니다.
1:1 문의하기 버튼 클릭 시 1:1 문의 내용을 입력할 수 있는 페이지를 제작하여 회원에게 제공합니다.
기본 스킨에서는 아래의 항목을 제공합니다.
- 문의유형
- 문의유형은 어드민에서 등록한 문의 유형을 select-box로 제공합니다. - 제목
- 제목은 최대 50자 까지 입력 가능합니다. - 내용
- 내용은 최대 1000자 까지 입력 가능합니다. - 첨부파일
- 첨부파일은 최대 10개 등록 가능하며, 1개 파일 당 용량은 5MB로 제한됩니다. - 답변등록 알림 (이메일, SMS 수신)
- 어드민의 자동 SMS 설정, 자동 메일 설정 여부에 따라 답글 등록 시 문의 등록자에게 답변 완료에 대해 안내됩니다.
- post1:1문의 등록
- /inquiries
1:1문의를 등록합니다.
1:1 문의 등록 페이지 내 내용을 입력한 후에는 1:1 문의 등록 페이지에서 문의 등록을 위해 저장 버튼을 클릭합니다.
저장 버튼 클릭 시 해당 API를 호출하여 게시글을 등록합니다.
응답값 내 inquiryType에서 inquiryTypeNo(1:1문의 유형번호) 항목 정보를 확인 가능합니다.
- put1:1문의 수정
- /inquiries/{inquiryNo}
특정 1:1문의를 수정합니다.
1:1 문의 수정하기를 위해서는 아래의 프로세스로 진행됩니다.
1) '1:1 문의 상세 조회하기 API'를 통해 수정하려는 1:1문의 내용을 조회 한 후 1:1문의 등록 팝업 내 등록한 문의 내용을 출력
2) 출력 된 내용을 기반으로 쇼핑몰 회원이 1:1문의를 수정하여 등록
3) '1:1문의 수정하기 API'를 통해 수정 요청
- delete1:1문의 삭제
- /inquiries/{inquiryNo}
특정 1:1문의를 삭제합니다.
1:1 문의 삭제는 1:1문의 상세 페이지에서 기능 제공하며, 답변이 완료 되지 않은 문의건에 대해서만 삭제 가능합니다.
1:1 문의 상세 조회 시 inquiryStatus (답변상태) 값이 답변완료인 경우 삭제 버튼을 미노출 하여 답변 완료인 경우 삭제 기능을 제공하지 않습니다.
답변이 완료되지 않은 1:1 문의의 경우 삭제 버튼 클릭 시 해당 API를 호출하여 특정 1:1 문의를 삭제 합니다.
🅑 상품 문의
상품문의는 어드민 [게시판 관리 > 게시판리스트] 설정에 따릅니다.
상품문의는 회원만 작성 가능하며, 비회원은 작성이 불가 합니다.
비밀글 설정은 어드민 설정에 따르며, 비밀글 쓰기 기능이 사용함인 경우 상품문의 등록 페이지에서 비밀글 여부를 설정할 수 있는 기능을 제공해야 합니다.

상품 문의 메뉴 접근 시 상품 문의 목록을 조회합니다.
- get상품문의 내역 조회
- /profile/product-inquiries
회원의 상품 문의글 목록을 조회합니다.
특정회원의 상품 문의만 조회해야 하므로 요청시 accessToken 값에 해당 회원의 엑세스 토큰값을 추가하여 조회 하셔야 합니다.
기본 스킨에서는 게시글 번호, 문의유형, 문의 정보(제목, 비밀글, 최신글 등), 문의일, 답변 상태 값을 노출하여 제공합니다.
등록된 상품 문의 상세 내용은 아래의 API를 통해 호출 가능합니다.
- get상품 문의 조회
- /products/{productNo}/inquiries/{inquiryNo}
상품번호로 상품 문의를 조회합니다.
상품 문의 조회하기 API를 통해 상품 문의 상세 페이지를 구성합니다.
1:1 문의와 마찬가지로 답변이 완료 되지 않은 문의 글에 대해서만 수정 및 삭제가 가능합니다.
수정/삭제 API는 하단 내용에서 확인하실 수 있습니다.

기본 스킨의 경우 상품문의 리스트에서 상품문의하기 버튼을 제공하고 있어 해당 버튼을 통해 게시글 등록이 가능합니다.
상품 문의하기 버튼 클릭 시 상품 문의를 등록할 수 있는 페이지를 제작하여 회원에게 제공합니다.
기본 스킨에서는 아래의 항목을 제공합니다.
- 문의유형
- 문의유형은 어드민에서 등록한 문의 유형을 select-box로 제공합니다. - 상품
- 문의할 상품을 선택할 수 있습니다.상품 선택버튼 클릭 시 상품을 선택할 수 있는 페이지를 제공합니다. - 내용
- 내용은 최대 1000자 까지 입력 가능합니다. - 비밀글 설정
- 어드민에서 비밀글 쓰기를 사용함으로 설정하는 경우 등록시 비밀글 여부를 선택할 수 있도록 기능이 제공됩니다.
- 어드민에서 비밀글 쓰기를 사용안함으로 설정하는 경우 등록시 비밀글 여부선택 항목은 제공되지 않아야 합니다. - 답변등록 알림 (이메일, SMS 수신)
- 어드민의 자동 SMS 설정, 자동 메일 설정 여부에 따라 답글 등록 시 문의 등록자에게 답변 완료에 대해 안내됩니다.
상품 항목에서는 상품을 선택할 수 있는 페이지를 제공합니다.

- get상품 검색
- /products/search
상품을 조회합니다.
기본 스킨에서는 상품 선택 팝업 내 상품 검색 시 '카테고리' , '검색어' 를 통해 조회할 수 있도록 제공하고 있습니다.
- post상품문의 등록
- /products/{productNo}/inquiries
상품문의를 등록합니다.
상품 선택 및 상품문의 내용을 입력한 후에는 상품 문의 등록 페이지에서 문의 등록을 위해 저장 버튼을 클릭합니다.
저장 버튼 클릭 시 해당 API를 호출하여 상품문의를 등록합니다.
상품문의 수정을 위해서는 아래의 단계로 진행됩니다.
1) 특정 상품문의 조회
2) 조회한 상품문의를 상품 문의 수정페이지 내 출력
3) 상품문의 수정
4) 상품 문의 수정 API 호출
먼저 앞서 언급한 GET /products/{productNo}/inquiries/{inquiryNo} 를 통해 특정 상품문의 내용을 조회합니다.
이후, 회원이 상품문의 등록페이지를 통해 수정한 내용을 아래의 API 를 호출하여 등록합니다.
- put상품문의 수정
- /products/inquiries/{inquiryNo}
상품문의를 수정합니다.
상품 문의는 작성자 본인만 수정 가능하여 회원 엑세스 토큰 accessToken 은 요청 시 필수로 입력해야 합니다.
수정이 가능한 범위는 문의유형, 내용, 비밀글 여부 에 대해서만 수정이 가능합니다.
- delete상품문의 삭제
- /products/inquiries/{inquiryNo}
특정 상품문의를 삭제합니다.
상품 문의 삭제는 상품문의 상세 페이지에서 기능 제공하며, 답변이 완료 되지 않은 문의건에 대해서만 삭제 가능합니다.
상품문의 상세 조회 시 inquiryStatus (답변상태) 값이 답변완료인 경우 삭제 버튼을 미노출 하여 답변 완료인 경우 삭제 기능을 제공하지 않습니다.
답변이 완료되지 않은 상품 문의의 경우 삭제 버튼 클릭 시 해당 API를 호출하여 특정 상품 문의를 삭제 합니다.
🅒 상품 후기
상품후기는 어드민 [게시판 관리 > 게시판리스트] 설정에 따릅니다.
상품후기는 회원만 작성 가능하며, 비회원은 작성이 불가 합니다.
비밀 글쓰기는 제공되지 않으며, 상품 후기는 답글 기능도 제공되지 않습니다.
첨부파일 기능은 어드민 설정에 따릅니다.

상품 후기 메뉴 접근 시 상품 후기 목록을 조회합니다.
- get상품후기 목록 조회
- /category/product-reviews
상품후기를 조회합니다.
기본 스킨의 경우 게시판은 카드형으로 제공하고 있으며, 아래의 항목으로 리스트를 구성합니다.
- 상품 정보 (상품 썸네일 / 상품명 / 옵션명)
- 별점
- 작성일
- 후기 정보 (후기 내용 / 첨부파일 여부)
- 작성 가능한 후기 버튼
작성 가능한 후기 버튼의 경우 클릭 시 후기 작성 페이지로 이동하며, 작성 가능한 후기 개수에 대해 카운트 하여 출력합니다.
- get작성 가능한 상품후기 목록 조회
- /profile/order-options/product-reviewable
회원이 작성 가능한 후기 목록을 조회합니다.
작성 가능한 상품 후기 목록은 구매한 상품의 옵션 기준으로 출력됩니다.
버튼 클릭 시 상품 후기 등록 페이지로 이동합니다.
상품 후기 목록에서 상품 썸네일 하단 영역을 클릭하면 상품 후기 상세 페이지로 이동합니다.
상품 후기 상세 페이지는 아래 API 를 통해 조회 가능합니다.
- get상품 후기 조회
- /products/{productNo}/product-reviews/{reviewNo}
상품 후기를 조회합니다.
상품 후기 조회 시 해당 회원이 등록한 상품 후기를 조회해야 하기 때문에 회원 엑세스 토큰 accessToken 값을 포함하여 요청합니다.
회원 본인이 작성한 상품 후기에 대해서 '수정' 및 '삭제' 기능을 제공합니다.
수정 / 삭제에 관한 내용은 아래에서 참고 부탁드립니다


기본 스킨에서는 상품 후기 등록 페이지에 아래의 항목을 제공합니다.
- 주문상품 선택 영역
- 나의 게시글 > 상품 후기에서 게시글 등록 시 상품 후기 등록이 가능한 주문상품 (옵션 기준)을 선택해야 합니다. - 평점
- 5점까지 설정 가능합니다. - 내용
- 최대 1000자 입력 가능합니다. - 첨부파일
- 첨부파일은 이미지파일 최대 10개까지 등록 가능하며, 1개당 용량은 5MB로 제한됩니다.
주문 상품 선택 버튼 클릭 시 주문상품을 선택할 수 있는 페이지로 이동합니다.

- get작성가능한 상품후기 목록 조회
- /profile/order-options/product-reviewable
회원이 작성 가능한 후기 목록을 조회합니다.
작성가능한 상품후기 목록 조회하기 API로 응답 받은 구매정보를 통해 상품 후기 등록가능한 구매상품을 출력합니다.
구매상품 선택 페이지에서 선택한 구매상품을 상품 후기 등록 페이지 내 주문상품 영역에 출력합니다.
주문상품 영역에 선택한 상품 출력은 아래의 API를 통해 처리 가능합니다.
- get상품 상세 조회
- /products/{productNo}
특정 상품번호에 대한 상품 정보를 조회합니다.
주문상품 선택, 평점, 후기 내용, 첨부파일 등 상품 후기 내용을 모두 입력한 뒤 저장 버튼을 클릭 시 아래 API를 호출합니다.
- post상품 후기 등록
- /products/{productNo}/product-reviews
상품 후기를 등록합니다.
상품후기 수정을 위해서는 아래의 단계로 진행됩니다.
1) 특정 상품 후기 조회
2) 조회한 상품 후기를 상품 후기 수정페이지 내 출력
3) 상품 후기 수정
4) 상품 후기 수정 API 호출
먼저 앞서 상품 후기 상세 페이지 구성 시 언급한 GET /products/{productNo}/product-reviews/{reviewNo} 를 통해 특정 상품 후기 내용을 조회합니다. 이후, 회원이 상품 후기 등록페이지를 통해 수정한 내용을 아래의 API 를 호출하여 등록합니다.
- put상품 후기 수정
- /products/{productNo}/product-reviews/{reviewNo}
상품 후기를 수정합니다.
상품 후기는 작성자 본인만 수정 가능하여 회원 엑세스 토큰 accessToken 은 요청 시 필수로 입력해야 합니다.
수정이 가능한 범위는 주문상품, 평점, 내용, 첨부파일 에 대해 수정이 가능합니다.
- delete상품 후기 삭제
- /products/{productNo}/product-reviews/{reviewNo}
특정 상품후기를 삭제합니다.
상품 후기 삭제는 상품후기 상세 페이지에서 기능 제공합니다.
상품 후기는 작성자만 삭제 가능하여 요청 시 회원 엑세스 토큰 accessToken을 필수값으로 전송해야 합니다.