고객과 컨설턴트를 위한 문패 API

{
  "name": "예시 고객",
  "phone": "010-0000-0000",
  "businessName": "문패 베이커리",
  "introduction": "매일 아침 크루아상을 굽는 동네 빵집입니다.",
  "privacyConsent": true
}

{
  "request": {
    "prompt": "대표 메뉴와 방문 안내를 따뜻하게 소개해 주세요.",
    "style": "따뜻하고 친근한",
    "theme": "오렌지",
    "name": "예시 고객",
    "phone": "010-0000-0000",
    "businessName": "문패 베이커리",
    "introduction": "매일 아침 크루아상을 굽는 동네 빵집입니다.",
    "privacyConsent": true
  },
  "quota": {
    "limit": 3,
    "used": 1,
    "remaining": 2,
    "resetsAt": "2026-09-07T12:00:00+00:00",
    "retryAfterSeconds": 0
  },
  "draft": {
    "id": "11111111-1111-4111-8111-111111111111",
    "prompt": "사업장명: 문패 베이커리\n한줄 소개: 매일 아침 크루아상을 굽는 동네 빵집입니다.\n추가 요청: 대표 메뉴와 방문 안내를 따뜻하게 소개해 주세요.",
    "style": "따뜻하고 친근한",
    "theme": "오렌지",
    "content": {
      "sections": [
        {
          "type": "hero",
          "title": "문패 베이커리",
          "subtitle": "매일 아침 굽는 크루아상",
          "cta": "방문 문의"
        },
        {
          "type": "about",
          "title": "우리 이야기",
          "body": "동네에서 만나는 작은 빵집입니다."
        },
        {
          "type": "contact",
          "title": "신청 · 문의",
          "body": "궁금한 점이나 신청 내용을 남겨 주세요."
        }
      ],
      "brandColor": "#C99550",
      "logoUrl": null,
      "copy": {
        "tagline": "동네에서 만나는 따뜻한 빵집"
      }
    },
    "createdAt": "2026-09-07T09:00:00+00:00",
    "previewUrl": "/Draft/Preview/11111111-1111-4111-8111-111111111111"
  }
}

{
  "sections": [
    { "type": "hero", "title": "문패 베이커리", "subtitle": "매일 아침 굽는 크루아상", "cta": "방문 문의" },
    { "type": "about", "title": "우리 이야기", "body": "동네에서 만나는 작은 빵집입니다." },
    { "type": "contact", "title": "신청 · 문의", "body": "궁금한 점이나 신청 내용을 남겨 주세요." }
  ],
  "brandColor": "#C99550",
  "logoUrl": null,
  "copy": { "tagline": "동네에서 만나는 따뜻한 빵집" }
}

// 실제 생성 요청입니다. 입력과 동의를 확인한 뒤 한 번만 실행하세요.
const input = {
  "name": "예시 고객",
  "phone": "010-0000-0000",
  "businessName": "문패 베이커리",
  "introduction": "매일 아침 크루아상을 굽는 동네 빵집입니다.",
  "privacyConsent": true,
  "prompt": "대표 메뉴와 방문 안내를 따뜻하게 소개해 주세요.",
  "style": "따뜻하고 친근한",
  "theme": "오렌지"
};
// 재시도에는 같은 requestId와 input을 유지하세요.
await fetch('/Draft/New', { credentials: 'same-origin' });
const requestId = crypto.randomUUID();
const response = await fetch('/api/v1/drafts', {
  method: 'POST',
  credentials: 'same-origin',
  headers: { 'Content-Type': 'application/json', 'Idempotency-Key': requestId },
  body: JSON.stringify(input)
});
const isJson = response.headers.get('content-type')?.includes('json');
const result = isJson ? await response.json() : null;
if (!response.ok) {
  // 429의 code와 Retry-After를 구분합니다. 자동 재시도하지 않습니다.
  const reason = result?.code ?? (result?.errors ? 'validation_failed' : 'request_failed');
  throw new Error(`HTTP ${response.status}: ${reason}; Retry-After=${response.headers.get('retry-after') ?? '없음'}`);
}
const { draft } = result;
// draft.content는 이미 객체입니다. JSON.parse를 다시 호출하지 않습니다.
const content = draft.content;
// 응답의 request에는 개인정보가 있으므로 콘솔/분석 도구에 기록하지 않습니다.
// 같은 브라우저 쿠키를 유지해야 미리보기에 접근할 수 있습니다.
location.assign(draft.previewUrl);

// 승인된 테스트 테넌트로만 호스트를 교체하세요. 서비스 홈페이지 금지.
const apiKey = process.env.MUNPAE_API_KEY;
if (!apiKey) throw new Error('Server-only test tenant key required');
const response = await fetch('https://authorized-test-tenant.example.invalid/api/v1/landing-page', {
  method: 'GET', redirect: 'error', credentials: 'omit',
  headers: { 'X-Api-Key': apiKey }
});
// 알려진 활성·검증 호스트의 404는 유효 키 + home 없음일 수 있습니다.
// 미확인 호스트의 미들웨어 404만으로 키가 유효하다고 판단하지 마세요.
if (!response.ok) throw new Error(`GET HTTP ${response.status}`);
const page = await response.json();
const rawContentJson = page.contentJson; // 문자열. GET은 손상된 기존 JSON도 그대로 반환합니다.
// 필요한 경우 try/catch로 JSON.parse 후 별도 검증하세요. 전체 응답/키는 로깅하지 않습니다.

{
  "sections": [
    { "type": "hero", "title": "테스트 베이커리", "subtitle": "승인된 테스트 사이트", "body": null, "cta": "방문 안내", "imageUrl": "/images/test.jpg", "items": null },
    { "type": "about", "title": "소개", "body": "매일 아침 빵을 굽습니다." },
    { "type": "services", "title": "메뉴", "items": ["크루아상", "식빵"] },
    { "type": "portfolio", "imageUrl": "https://images.example.invalid/test.jpg" },
    { "type": "contact", "title": "방문 안내", "body": "테스트 전용 안내입니다." }
  ],
  "brandColor": "#C99550",
  "logoUrl": null,
  "copy": { "tagline": "테스트 전용", "Tagline": "서로 다른 사전 키" }
}

{
  "title": "테스트 베이커리",
  "contentJson": "{\n  \"sections\": [\n    { \"type\": \"hero\", \"title\": \"테스트 베이커리\", \"subtitle\": \"승인된 테스트 사이트\", \"body\": null, \"cta\": \"방문 안내\", \"imageUrl\": \"/images/test.jpg\", \"items\": null },\n    { \"type\": \"about\", \"title\": \"소개\", \"body\": \"매일 아침 빵을 굽습니다.\" },\n    { \"type\": \"services\", \"title\": \"메뉴\", \"items\": [\"크루아상\", \"식빵\"] },\n    { \"type\": \"portfolio\", \"imageUrl\": \"https://images.example.invalid/test.jpg\" },\n    { \"type\": \"contact\", \"title\": \"방문 안내\", \"body\": \"테스트 전용 안내입니다.\" }\n  ],\n  \"brandColor\": \"#C99550\",\n  \"logoUrl\": null,\n  \"copy\": { \"tagline\": \"테스트 전용\", \"Tagline\": \"서로 다른 사전 키\" }\n}"
}

# 서버 전용. munpae.kr 서비스 홈페이지에 PUT 테스트하지 마세요.
# home이 없으면 생성하여 마케팅 대체 화면까지 바꿉니다. 백업·승인 후 실행하세요.
# HTTP 금지. --location/-L 금지. 키를 로그에 남기는 --verbose/--trace 금지.
curl --proto '=https' --max-redirs 0 --fail-with-body --include \
  --request PUT 'https://authorized-test-tenant.example.invalid/api/v1/landing-page' \
  --header "X-Api-Key: ${MUNPAE_API_KEY:?Set a server-only test tenant key}" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "title": "테스트 베이커리",
  "contentJson": "{\n  \"sections\": [\n    { \"type\": \"hero\", \"title\": \"테스트 베이커리\", \"subtitle\": \"승인된 테스트 사이트\", \"body\": null, \"cta\": \"방문 안내\", \"imageUrl\": \"/images/test.jpg\", \"items\": null },\n    { \"type\": \"about\", \"title\": \"소개\", \"body\": \"매일 아침 빵을 굽습니다.\" },\n    { \"type\": \"services\", \"title\": \"메뉴\", \"items\": [\"크루아상\", \"식빵\"] },\n    { \"type\": \"portfolio\", \"imageUrl\": \"https://images.example.invalid/test.jpg\" },\n    { \"type\": \"contact\", \"title\": \"방문 안내\", \"body\": \"테스트 전용 안내입니다.\" }\n  ],\n  \"brandColor\": \"#C99550\",\n  \"logoUrl\": null,\n  \"copy\": { \"tagline\": \"테스트 전용\", \"Tagline\": \"서로 다른 사전 키\" }\n}"
}'

// munpae.kr에 실행 금지. 승인된 테스트 테넌트만 사용하며 기존 원문을 먼저 백업하세요.
const apiKey = process.env.MUNPAE_API_KEY;
if (!apiKey) throw new Error('Server-only test tenant key required');
const input = {
  "title": "테스트 베이커리",
  "contentJson": "{\n  \"sections\": [\n    { \"type\": \"hero\", \"title\": \"테스트 베이커리\", \"subtitle\": \"승인된 테스트 사이트\", \"body\": null, \"cta\": \"방문 안내\", \"imageUrl\": \"/images/test.jpg\", \"items\": null },\n    { \"type\": \"about\", \"title\": \"소개\", \"body\": \"매일 아침 빵을 굽습니다.\" },\n    { \"type\": \"services\", \"title\": \"메뉴\", \"items\": [\"크루아상\", \"식빵\"] },\n    { \"type\": \"portfolio\", \"imageUrl\": \"https://images.example.invalid/test.jpg\" },\n    { \"type\": \"contact\", \"title\": \"방문 안내\", \"body\": \"테스트 전용 안내입니다.\" }\n  ],\n  \"brandColor\": \"#C99550\",\n  \"logoUrl\": null,\n  \"copy\": { \"tagline\": \"테스트 전용\", \"Tagline\": \"서로 다른 사전 키\" }\n}"
};
// contentJson은 문자열입니다. 객체를 만들었다면 JSON.stringify(content)를 넣으세요.
const response = await fetch('https://authorized-test-tenant.example.invalid/api/v1/landing-page', {
  method: 'PUT', redirect: 'error', credentials: 'omit',
  headers: { 'X-Api-Key': apiKey, 'Content-Type': 'application/json' },
  body: JSON.stringify(input)
});
const isJson = response.headers.get('content-type')?.includes('json');
const result = isJson ? await response.json() : null;
if (!response.ok) {
  // 409 landing_page_busy: Retry-After: 1. 자동 재시도하지 말고 현재 내용을 확인하세요.
  throw new Error(`PUT HTTP ${response.status}; Retry-After=${response.headers.get('retry-after') ?? '없음'}`);
}
const page = result; // 201 생성 / 200 교체. 이미 공개됨. 응답/키는 로깅하지 않습니다.

{
  "id": "22222222-2222-4222-8222-222222222222",
  "slug": "home",
  "title": "테스트 베이커리",
  "contentJson": "{\n  \"sections\": [\n    { \"type\": \"hero\", \"title\": \"테스트 베이커리\", \"subtitle\": \"승인된 테스트 사이트\", \"body\": null, \"cta\": \"방문 안내\", \"imageUrl\": \"/images/test.jpg\", \"items\": null },\n    { \"type\": \"about\", \"title\": \"소개\", \"body\": \"매일 아침 빵을 굽습니다.\" },\n    { \"type\": \"services\", \"title\": \"메뉴\", \"items\": [\"크루아상\", \"식빵\"] },\n    { \"type\": \"portfolio\", \"imageUrl\": \"https://images.example.invalid/test.jpg\" },\n    { \"type\": \"contact\", \"title\": \"방문 안내\", \"body\": \"테스트 전용 안내입니다.\" }\n  ],\n  \"brandColor\": \"#C99550\",\n  \"logoUrl\": null,\n  \"copy\": { \"tagline\": \"테스트 전용\", \"Tagline\": \"서로 다른 사전 키\" }\n}",
  "createdAt": "2026-09-07T09:00:00+00:00",
  "updatedAt": "2026-09-07T09:00:00+00:00"
}

# 고객사 테스트 주소로 바꾸세요. 키는 서버 환경 변수에서 읽어요.
curl --proto '=https' --max-redirs 0 --fail-with-body \
  'https://authorized-test-tenant.example.invalid/api/v1/blog-posts?page=1&pageSize=20&status=draft' \
  --header "X-Api-Key: ${MUNPAE_API_KEY:?Set a server-only test tenant key}"

const apiKey = process.env.MUNPAE_API_KEY;
if (!apiKey) throw new Error('Set MUNPAE_API_KEY on the server');
const base = 'https://authorized-test-tenant.example.invalid';
const input = {
  "title": "이번 주 카페 메뉴를 소개해요",
  "slug": "weekly-menu",
  "summary": "이번 주에 준비한 메뉴와 방문 안내예요.",
  "contentMarkdown": "## 이번 주 메뉴\n\n따뜻한 라떼와 갓 구운 스콘을 준비했어요.",
  "category": "매장 소식",
  "tags": "카페,메뉴",
  "coverImageUrl": null,
  "ctaType": "inquiry",
  "ctaReservationUrl": null,
  "publish": false
};
async function call(path, method = 'GET', body) {
  const response = await fetch(base + path, {
    method, redirect: 'error', credentials: 'omit',
    headers: { 'X-Api-Key': apiKey, 'Content-Type': 'application/json' },
    ...(body === undefined ? {} : { body: JSON.stringify(body) })
  });
  if (!response.ok) throw new Error(`Blog API HTTP ${response.status}`);
  return response.json();
}
// POST는 새 글을 만들어요. 응답을 잃으면 목록을 먼저 확인하고 자동 재시도하지 마세요.
const created = await call('/api/v1/blog-posts', 'POST', input);
const path = '/api/v1/blog-posts/' + created.id;
const current = await call(path);
// PUT에는 전체 입력을 보내요. 응답 객체 전체를 그대로 보내면 안 돼요.
// 발행할 때만 내용을 검토한 뒤 publish를 true로 바꾸세요.
const saved = await call(path, 'PUT', { ...input, slug: current.slug, title: '이번 주 메뉴 안내', publish: false });
// API 키와 비공개 글 내용을 로그에 남기지 마세요.

{
  "name": "예시 고객",
  "email": "customer@example.invalid",
  "phone": "010-0000-0000",
  "message": "방문 예약 방법을 안내받고 싶습니다.",
  "privacyConsent": true
}

curl --proto '=https' --max-redirs 0 --fail-with-body \
  'https://authorized-test-tenant.example.invalid/api/v1/inquiries?page=1&pageSize=20&isRead=false' \
  --header "X-Api-Key: ${MUNPAE_API_KEY:?Set a server-only test tenant key}"

const apiKey = process.env.MUNPAE_API_KEY;
if (!apiKey) throw new Error('Set MUNPAE_API_KEY on the server');
const base = 'https://authorized-test-tenant.example.invalid';
async function call(path, method = 'GET', body) {
  const response = await fetch(base + path, {
    method, redirect: 'error', credentials: 'omit', cache: 'no-store',
    headers: { 'X-Api-Key': apiKey, 'Content-Type': 'application/json' },
    ...(body === undefined ? {} : { body: JSON.stringify(body) })
  });
  if (!response.ok) throw new Error(`Inquiry API HTTP ${response.status}`);
  return response.status === 204 ? undefined : response.json();
}
const list = await call('/api/v1/inquiries?isRead=false&page=1&pageSize=20');
// list.items에는 id, isRead, createdAt만 있어요. 다음 목록은 page를 늘려 읽으세요.
const first = list.items[0];
if (first) {
  const path = '/api/v1/inquiries/' + first.id;
  const detail = await call(path);
  // detail의 이름·이메일·본문은 권한 있는 업무 화면에서만 사용하세요.
  // 실제 담당자가 확인한 뒤 실행하세요. 읽음은 답변 발송을 뜻하지 않아요.
  // await call(path, 'PATCH', { isRead: true });
  // 보유 목적이 끝나 삭제하기로 결정한 경우에만 실행하세요. 복구할 수 없어요.
  // await call(path, 'DELETE');
}
// 응답, API 키, 고객 개인정보를 콘솔·Slack·오류 추적 도구에 남기지 마세요.

{
  "id": "11111111-1111-4111-8111-111111111111",
  "version": 1,
  "type": "inquiry.created",
  "tenantId": "22222222-2222-4222-8222-222222222222",
  "occurredAt": "2026-09-07T08:00:00+00:00",
  "data": { "id": "33333333-3333-4333-8333-333333333333" }
}

webhook-id: 11111111-1111-4111-8111-111111111111
webhook-timestamp: <이번 전송 시도의 Unix 초>
webhook-signature: v1,<Base64 HMAC-SHA256>

서명 원문 = id + "." + timestamp + "." + 파싱 전 JSON 원문
HMAC 키 = whsec_ 접두사를 제거하고 Base64 디코딩한 32바이트

// 문서에 연결된 customer-webhook-receiver.mjs를 함께 배치하세요.
import { verifyWebhook, acceptOnce } from './customer-webhook-receiver.mjs';
// HTTP 핸들러에서 받은 headers, rawBody(Buffer)를 전달하세요.
export async function accept(headers, rawBody) {
  const event = verifyWebhook({
    headers, rawBody,
    secret: process.env.MUNPAE_WEBHOOK_SECRET,
    tenantId: process.env.MUNPAE_TENANT_ID
  });
  // 서명·5분 시각·테넌트·스키마를 확인한 뒤, 영속 디스크에 ID를 한 번만 저장해요.
  await acceptOnce(process.env.MUNPAE_WEBHOOK_SPOOL, event, rawBody);
  // 이 작업이 성공한 뒤에만 HTTP 202로 응답하세요.
  // Make/Zapier 전달은 별도 소비자가 처리하고 최상위 event.id로 중복 업무를 막으세요.
}

{
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": { "name": ["이름을 입력해 주세요."] }
}

{
  "code": "free_quota_exceeded",
  "error": "이번 3시간의 무료 생성 횟수(3회)를 모두 사용했습니다. 초기화 시각 이후 다시 시도해 주세요.",
  "quota": { "limit": 3, "used": 3, "remaining": 0, "resetsAt": "2026-09-07T12:00:00+00:00", "retryAfterSeconds": 10800 }
}