콘텐츠로 이동

외부 연동

웹빌더가 Notion을 콘텐츠의 소스로 쓰고, 고객이 자기 도메인을 달고, 결제까지 받는다고 하면 그건 전부 우리 시스템 바깥의 서비스와 손을 잡는 일이에요. 이 카테고리에서 다루는 '연동'은 그래서 제품의 실제 가치가 되는 부분이에요. 기능 하나하나는 사소해 보여도, 이게 맞물려서 '고객이 자기 콘텐츠로 웹사이트를 완성하고 돈을 받는' 전체 흐름이 만들어지죠.

연동을 다룰 때 처음부터 기억할 점 하나는, 외부 서비스는 우리가 통제할 수 없다는 거예요. API가 바뀌고, 인증이 만료되고, 속도가 느려지는 일이 남의 손에 달려 있어요. 그래서 연동마다 '실패했을 때 어떻게 동작할지'(재시도·웹훅·수동 처리)를 같이 설계하는 게 중요해요.

상태 배지

이 위키에서는 기술마다 적용 정도를 배지로 표시합니다.

  • 🟢 운영 — 제품에 실제로 돌아가고 있는 기술
  • 🔵 적용 — 도입했거나 적용 중인 기술

Notion API와 Cloudflare는 🟢 운영, Toss 결제는 🔵 적용 상태로 보고 있어요.

하위 기술 딥 페이지

외부 연동의 핵심 세 기술은 각각 별도 페이지로 정리했어요.

  • Notion API (🟢 운영) — Notion 페이지·DB를 읽고 쓸 수 있는 공식 API. 웹빌더가 콘텐츠를 Notion에서 가져오는 핵심 경로예요.
  • Toss Payments (🔵 적용) — 토스페이먼츠가 제공하는 결제 연동 API. 카드·간편결제 등 다양한 수단을 코드 몇 줄로 붙일 수 있어요.
  • Cloudflare (🟢 운영) — 전 세계에 분산된 DNS·CDN 서비스. 속도와 안정성, 보안(방화벽)까지 함께 잡아줘요.

함께 쓰는 기술 (목차)

딥 페이지는 따로 없지만 같은 흐름에 묶여 쓰는 기술들이에요. 대표적인 실사용 흐름이 Notion → 웹빌더 → 커스텀 도메인 → 결제예요. 사용자가 Notion에 콘텐츠를 쓰면 웹훅+API로 가져오고, 마크다운으로 변환해 웹사이트로 만들고, 고객이 가비아·Cloudflare에서 산 도메인을 연결하고, 방문자가 상품을 사면 Toss 결제와 결제 웹훅으로 구독이 열립니다.

  • 가비아 / 가비아 OAuth API (🟢 운영) — 국내 도메인·호스팅 서비스. OAuth로 인증받아 고객 도메인의 DNS 설정을 자동화할 수 있어요.
  • AWS Route 53 / Let's Encrypt (🟢 운영) — AWS의 DNS 서비스와 HTTPS 인증서를 자동 발급해 주는 인증 기관. 커스텀 도메인마다 인증서를 자동으로 붙여줘요.
  • 정기결제 / 에스크로 / 결제 Webhook (🟢 운영) — 요금제 상품의 근간이 되는 구독 결제와, 고액 거래의 신뢰를 위한 에스크로, 결제 상태를 알려주는 콜백이에요.
  • 실시간 알림(WebSocket / SSE) (🟢 운영) — 서버가 브라우저에 실시간으로 이벤트를 밀어주는 기술. WebSocket은 양방향, SSE는 서버→클라이언트 단방향이에요.
  • KG이니시스 / Stripe (⚪ 역량) — 사업 확장 때를 대비해 다룰 줄 아는 결제 대행사 기술이에요.
  • 비즈뿌리오 알림톡 / SendGrid (⚪ 역량) — 카카오 알림톡과 이메일 대량 발송으로, 도입하면 더 좋아질 것으로 보는 역량이에요.

실제 적용

도메인 연결은 가비아 OAuth API + Route 53 / Cloudflare DNS가 함께 동작해요. 우리가 직접 고객 DNS를 잡아두고, 인증서는 Let's Encrypt로 자동 갱신해서 '도메인만 사면 나머지는 자동'이 되게 하는 게 목표예요. 알림은 지금 실시간 알림(WebSocket/SSE)이 운영에 있고, 알림톡·SendGrid는 도입하면 더 좋아질 것으로 보고 있어요(⚪). 자세한 내용은 각 딥 페이지와 기술 스택 허브에서 이어집니다.

더 알아보기