MYMY Publishing Demo

MYMY 웹훅으로 콘텐츠 DB 자동 갱신하기

MYMY에서 콘텐츠가 바뀌면 웹훅이 옵니다. 웹훅에는 어떤 콘텐츠가 바뀌었는지만 들어 있어서, 받는 쪽이 MYMY API로 상세를 다시 가져와 DB에 저장합니다. 아래 코드와 샘플은 이 데모 프로젝트에서 실제로 쓰고 받은 것입니다.

외부 라이브러리 사용하지 않음
목차

①처리 흐름

직접 구현할 핵심은 STEP 3·4입니다. 요청을 받아 바로 응답하고, 콘텐츠 정보를 다시 가져와 갱신하는 부분입니다.

  1. MYMY

    MYMY 웹훅

    변경 알림 POST

  2. STEP 1

    서명 검증

    선택

  3. STEP 2

    중복 제거

    같은 요청은 건너뜀

  4. STEP 3 · 주요 구현부

    요청 접수·200 응답

    바로 응답

  5. STEP 4 · 주요 구현부

    MYMY 콘텐츠 조회 API 호출

    결과를 contents에 저장

②웹훅 요청 예시

로컬에서 실제로 받은 요청이고, 헤더는 일부만 옮겼습니다. 본문에 콘텐츠 내용은 없고 이벤트 종류, contentId, title만 있습니다.

HTTP 헤더 (일부)
x-webhook-id: af80439a-b491-4ac5-b48c-dc4d97d1ad48
x-webhook-timestamp: 1794371158
x-webhook-signature: sha256=c5929a6f0aa1414f03666148df5b1e2316bb0c71b17d471fdaa1523d2ec35111
content-type: application/json
본문 (JSON)
{
  "id": "af80439a-b491-4ac5-b48c-dc4d97d1ad48",
  "event": "content.created",
  "timestamp": "2026-11-11T04:25:58.191Z",
  "data": {
    "contentId": "2b1ff8a5a3e34eeebe83",
    "title": "fallback-title"
  }
}

③단계별 구현

실제 소스에서 가져왔고, 줄인 부분은 // … 로 표시했습니다.

STEP 1서명 검증 (선택)

필요할 때만 넣으면 됩니다. 내부망에서만 받는다면 생략해도 되지만, 외부에 열린 주소라면 누구나 요청을 보낼 수 있으니 MYMY가 보낸 요청인지 확인하는 편이 안전합니다. 타임스탬프 검사는 예전 요청을 가로채 다시 보내는 것도 막습니다.

secret으로 "{timestamp}.{rawBody}"의 HMAC-SHA256을 계산해 X-Webhook-Signature 헤더 값과 비교합니다. 타임스탬프가 5분 넘게 차이 나면 거절합니다. 이 데모는 검증을 켜 둔 상태입니다.
src/lib/mymy/webhook.ts
if (Math.abs(now - Number(timestamp)) > toleranceSec) {   // 기본 300초
  return { ok: false, reason: `타임스탬프 허용 범위(${toleranceSec}초) 초과` };
}
const received = signatureHeader.replace(/^sha256=/, "");
// …
const expected = createHmac("sha256", secret)
  .update(`${timestamp}.${rawBody}`, "utf8")
  .digest();
if (!timingSafeEqual(expected, Buffer.from(received, "hex"))) {
  return { ok: false, reason: "서명 불일치" };
}
return { ok: true };
STEP 2중복 제거

MYMY는 응답이 늦거나 5xx를 받으면 같은 이벤트를 다시 보냅니다. 걸러내지 않으면 같은 처리가 두 번 돌고 이력도 두 줄 쌓입니다.

X-Webhook-Id에 unique 인덱스를 걸어 두면 두 번째 요청은 저장되지 않으니, 200만 돌려주고 끝내면 됩니다.
src/app/api/webhooks/mymy/route.ts
const inserted = db
  .insert(webhookEvents)
  .values(values)
  .onConflictDoUpdate({
    target: webhookEvents.eventId,          // X-Webhook-Id
    set: values,
    setWhere: isNull(webhookEvents.payload), // 수신 단계에서 거부된 행만 덮어씀
  })
  .returning({ id: webhookEvents.id })
  .get();

if (!inserted) return json({ ok: true, duplicate: true }, 200);
STEP 3MYMY에 먼저 응답한 뒤 내부 처리

MYMY는 응답을 10초까지만 기다립니다. MYMY 콘텐츠 조회 API 호출까지 끝내고 응답하면 이 시간을 넘길 수 있고, 그러면 처리는 됐는데도 실패로 기록됩니다.

요청을 DB에 접수하는 즉시 MYMY에 200을 돌려줍니다. 콘텐츠 조회 API 호출과 DB 갱신 같은 내부 작업은 응답을 보낸 뒤 Next.js의 after()로 이어서 처리합니다. 서명 검증을 쓴다면, 서명이 틀린 요청에는 401을 돌려 재시도를 막습니다.
src/app/api/webhooks/mymy/route.ts
// 응답 코드: 2xx 성공 / 400·401 즉시 실패 / 5xx 재시도 (MYMY 타임아웃 10초)
if (!verified.ok) {
  reject(base, false, false, `서명 검증 실패: ${verified.reason}`);
  return json({ ok: false, error: "invalid signature" }, 401);
}
// …
after(() => processWebhookEvent(inserted.id));   // 응답 후 비동기 처리
return json({ ok: true }, 200);
STEP 4이벤트 정보로 MYMY API에서 콘텐츠 정보 가져오기

웹훅에는 contentId와 title 정도만 들어 있어 메타데이터나 썸네일을 채울 수 없습니다. 또 이벤트가 두 번 오거나 순서가 뒤바뀌어도, 매번 MYMY의 현재 상태를 가져오면 DB가 어긋나지 않습니다.

웹훅으로 받은 이벤트 정보(event, data.contentId)로 MYMY API(GET /api/contents/:id)를 Bearer 토큰과 함께 호출해 콘텐츠 정보를 가져오고, 그 결과로 contents를 통째로 갱신합니다. 바뀐 부분만 골라 고치는 코드는 필요 없습니다.
  • content.bulk_updated 이벤트도 대응 필요
  • contentId 대신 contentIds 배열로 전달 → 콘텐츠마다 같은 조회·갱신 반복
  • 대량 업데이트가 잦으면 콘텐츠 ID를 내부 큐에 넣고 작업자가 나눠 처리하는 방식 권장
src/lib/mymy/client.ts
const url = `${baseUrl.replace(/\/+$/, "")}/api/contents/${encodeURIComponent(contentId)}`;
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${token}`, Accept: "application/json" },
  cache: "no-store",
  signal: AbortSignal.timeout(TIMEOUT_MS),
});

if (res.status === 404) return null;
src/lib/mymy/sync.ts
const updates: Omit<NewContent, "contentId"> = {
  title:
    metadata.title ||
    asString(data.title) ||
    existing?.title ||
    contentId,
  contentType: detail.contentType ?? null,
  // …
  status: detail.deletedAt ? "trashed" : "published",
  lastEventId: eventId,
  syncedAt: new Date(),
  syncError: null,
};
db.insert(contents)
  .values({ contentId, ...updates })
  .onConflictDoUpdate({ target: contents.contentId, set: updates })
  .run();

④상황별 처리

이벤트 종류는 많아도 DB를 바꾸는 처리는 두 가지뿐입니다. 최신 정보를 다시 받아 콘텐츠 정보를 갱신하거나, 숨기거나 지웁니다.

콘텐츠 추가
content.created
MYMY API에서 상세와 메타정보를 받아 contents에 새 행으로 저장합니다.
콘텐츠·메타정보 수정
content.updatedcontent.metadata_updatedcontent.bulk_updated
최신 메타정보를 다시 받아 콘텐츠 정보를 갱신합니다. 여러 건이 한꺼번에 바뀌면(bulk) 한 건씩 같은 처리를 반복합니다.
인코딩(워크플로) 완료·실패
workflow.completedworkflow.failed
content.created는 업로드 직후, 인코딩 전에 도착하므로 썸네일·프록시가 비어 있을 수 있습니다. 완료(completed)되면 MYMY 상세를 다시 받아 썸네일·프록시를 채우고, 실패(failed)하면 다시 받은 뒤 syncError에 실패 사실을 기록합니다. 이 두 이벤트는 MYMY 웹훅 엔드포인트 설정에서 직접 구독해야 도착합니다.
휴지통 이동·영구 삭제
content.trashedcontent.permanently_deleted
휴지통이면 상태만 trashed로 바꿔 목록에서 숨기고, 영구 삭제면 행을 지웁니다.
그 외 (연결 테스트 등)
ping
수신 이력만 남기고 DB는 건드리지 않습니다.

복원(content.restored), 워크플로 완료(workflow.completed), 아카이브 완료(archive.completed)도 수정과 똑같이 최신 정보를 다시 받습니다. 콘텐츠 조회 API 호출에 실패하면 수신 이력에 실패 사유가 남고, 해당 콘텐츠에는 sync_error가 기록됩니다.

⑤저장 결과

②의 웹훅으로 contents에 저장된 내용입니다. 웹훅에는 contentId와 title만 들어 있으므로, 이 contentId로 MYMY API를 호출해 메타데이터·썸네일 같은 필요한 정보를 추가로 가져옵니다.

1. 받은 웹훅

data.contentId = 2b1ff8a5a3e34eeebe83

data.title = fallback-title

2. MYMY API 조회
웹훅의 contentId로 콘텐츠 상세를 요청합니다.

GET {MYMY_API_URL}/api/contents/2b1ff8a5a3e34eeebe83

Authorization: Bearer {MYMY_API_TOKEN}

응답의 data에서 콘텐츠 유형, 메타데이터, 업로더, 썸네일·프록시 URL, 등록·수정 시각을 가져옵니다. MYMY에 콘텐츠가 없으면(404) 새로 저장하지 않습니다.

3. 저장된 콘텐츠
컬럼값
content_id2b1ff8a5a3e34eeebe83웹훅 data.contentId
title지수_13웹훅의 title(fallback-title)보다 API의 metadata.title을 먼저 씀
content_typeIMAGEAPI
statuspublishedAPI의 deletedAt이 비어 있으면 published
metadata{"title":"지수_13","description":"설명 업데이트","original_filename":"지수_13.jpg","mime_type":"image/jpeg","resolution":"680x979","file_size":"449804.000000","archive_status":"ARCHIVED", …}API metadata (JSON)
uploader_name · thumbnail_url · proxy_urlAPI 응답에서 채움category_id, metadata_fields도 마찬가지
mymy_created_at · mymy_updated_atAPI 응답에서 채움
last_event_idaf80439a-b491-4ac5-b48c-dc4d97d1ad48X-Webhook-Id
synced_at동기화 시각서버 시각

⑥도입 준비

  • 환경변수
    • MYMY_API_URL: MYMY API 주소
    • MYMY_API_TOKEN: MYMY API 호출용 Bearer 토큰
    • MYMY_WEBHOOK_SECRET: 서명 검증을 쓸 때만 필요, 엔드포인트 등록 시 MYMY가 보여 주는 서명 키
  • MYMY 설정
    • 웹훅 주소(https://내-서비스-주소/api/webhooks/mymy)를 MYMY의 웹훅 엔드포인트로 등록
    • MYMY 서버에서 호출할 수 있는 주소여야 함 (localhost·내부망 전용 주소는 MYMY가 접근하지 못하면 수신 불가)