# 오늘의화환 청첩장 화환 링크 — 연동 설명서 (AI용)

모바일 청첩장에 "화환으로 마음 전하기" 섹션을 넣는 방법입니다.
하객은 화환을 보내고(로그인 없음), 보낸 분 목록이 청첩장에 표시되며,
화환 적립금은 신랑신부에게 쌓여 누적 10,000P부터 기프티콘으로 바꿀 수 있습니다.

## 준비
신랑신부가 https://오늘의화환.com/wedding-gift/new 에서 화환 링크를 만들면 코드(영숫자 10자)가 나옵니다. 아래 {CODE} 자리에 넣으세요.

## 방법 1 — iframe (가장 간단)
<iframe src="https://오늘의화환.com/w/{CODE}/embed" title="화환으로 마음 전하기" style="width:100%;max-width:480px;height:440px;border:0;display:block;margin:0 auto" loading="lazy"></iframe>
- 높이 자동 맞춤(선택): iframe 이 window.parent 로 { type: "wedding-gift-height", height } 를 postMessage 합니다.

## 방법 2 — 공개 API 로 직접 그리기
GET https://오늘의화환.com/public/wedding-gifts/{CODE}
- 인증·키 없음, CORS 전체 허용, 읽기 전용, 30초 캐시
- 응답 필드:
  - orderable (boolean): 지금 주문 가능 여부. false 면 "화환 주문이 마감되었어요" 표시
  - orderUrl (string): 하객 주문 페이지. "화환 보내기" 버튼은 이 주소를 새 창(target=_blank)으로 연다
  - senders (array): [{ name, sentAt }] — name 은 리본의 '보내는 분' 문구(비공개 선택 시 "익명")
  - senderCount (number), showSenders (boolean: false 면 목록을 그리지 말 것)
  - groomName, brideName, ceremonyDate(YYYY-MM-DD), ceremonyTime(HH:mm), venueName, hallName, closesAt(KST ISO)

## 지켜야 할 것
- 결제·주문 화면을 직접 만들지 말 것. 주문은 항상 orderUrl 에서 한다.
- senders[].name 은 사용자 입력이므로 HTML 로 넣을 때 반드시 이스케이프(textContent 사용).
- 문구 예: 제목 "화환으로 마음 전하기", 버튼 "화환 보내기", 안내 "보내 주신 화환의 적립금은 두 분께 기프티콘으로 전해집니다."

사람이 읽는 안내: https://오늘의화환.com/wedding-gift