가이드

커뮤니티필수 마이페이지필수

설치 순서

필수 화면을 먼저 연결한 뒤 채널과 운영 정책을 공개하는 순서가 안전합니다.

1단계

기본 정보

커뮤니티 이름과 로그인·화면 주소를 설정합니다.

2단계

필수 스니펫

커뮤니티와 마이페이지 스니펫을 각 쇼핑몰 화면에 삽입합니다.

3단계

채널·정책

채널 권한, 익명 사용, 금칙어와 리워드 정책을 확인합니다.

4단계

동작 확인

로그인, 작성, 댓글, 해시태그와 운영 조치 흐름을 테스트합니다.

기본 설정 채널 설정

쇼핑몰 메인이나 기획전에서 특정 채널의 최신·인기 게시글을 진열하는 선택 기능입니다.

위젯 옵션

채널 선택

피드 형태

진열 개수

정렬 기본값

커뮤니티 페이지 URL

카드 클릭 시 이동할 커뮤니티 페이지 경로입니다. 게시글 상세는 자동으로 ?view=detail&post_id=xxx 파라미터가 붙습니다.

스니펫

<!-- SOMOON 메인 위젯 (layout.html에 <script> 이미 추가된 경우 생략) -->
<script src="https://somoon-widget.dfy.me/somoon.js" defer></script>
<div id="somoon-feed"
     data-view="feed"
     data-layout="card"
     data-limit="10"
     data-sort="latest"
     data-community-url="/somoon.html">
</div>

API 연동 정보

위젯 개발자가 현재 설정값으로 게시글을 요청할 때 사용하는 엔드포인트입니다.

요청 (현재 옵션 기준)

GET https://apps.dfy.me/api/posts?pageSize=10&sort=latest
X-Mall-Id: devmall

boardIdstring?

채널(게시판) ID. 생략 시 전체

pageSizenumber

진열 개수 (최대 50)

sortstring

latest | popular | comments

pagenumber?

페이지 번호. 기본값 1

응답 구조

{
  "content": [
    {
      "id": "uuid",
      "boardId": "uuid",
      "boardName": "자유게시판",
      "authorNickname": "닉네임",
      "thumbnailUrl": "https://...",
      "videoUrl": null,
      "content": "<p>HTML 본문</p>",
      "tags": ["태그1"],
      "likeCount": 12,
      "commentCount": 3,
      "createdAt": "2025-01-01T00:00:00"
    }
  ],
  "totalCount": 36,
  "page": 1,
  "pageSize": 10
}

미리보기

현재 설정 기준 실제 게시글

검색