임베드 API를 사용하면 여러분 자신의 백엔드가 여러분의 최종 사용자를 MailInApp 강좌나 웨비나에 등록·신청시키고 뷰어를 앱에 임베드할 수 있습니다 — 그 사용자가 MailInApp 대시보드 계정을 건드릴 일은 전혀 없습니다.
여러분의 최종 사용자는 MailInApp이 아니라 여러분의 것입니다 — 여러분을 대신해 호스팅하는 강좌를 보기 위해 별도의 계정을 만들 필요는 없어야 합니다.
여러분의 백엔드, 여러분의 자격 부여
POST /api/v1/courses/[id]/enroll은 이메일 주소에 대한 강좌 접근 권한을 부여하거나 취소하고, POST /api/v1/webinars/[id]/register는 웨비나 참가자를 등록합니다 — 둘 다 발송 API와 동일한 베어러 API 키로 인증됩니다. 누가 자격이 있는지는 여러분 자신의 결제나 체크아웃 시스템이 결정하며, MailInApp은 그 결과를 렌더링할 뿐입니다.
실제 뷰어 임베드하기
신청이 완료되면 POST /api/v1/courses/[id]/embed-token이 단기 서명 토큰을 발급합니다. 앱의 iframe이나 창을 반환된 URL로 리디렉션하면 뒤에서 결정적인 로그인이 부트스트랩됩니다 — 최종 사용자는 내내 여러분의 앱만 보게 되며, MailInApp 로그인은 전혀 보지 않습니다.
원한다면 등록 주변의 인터랙티브 이메일
강좌나 웨비나의 lifecycleBindings는 registered/reminder/enrolled/completed 이벤트를 스튜디오 프로젝트로 연결할 수 있습니다 — 실제 참여 버튼이 있는 미팅 링크, 시작 시각까지의 카운트다운처럼요. 아무것도 연동되지 않으면 자동으로 단순 텍스트 문구로 대체되므로, 선택해도 기존 설정이 절대 깨지지 않습니다.
같은 키, 별도의 할당량
임베드 API는 발송 API의 키당 분당 60개 요청 제한을 공유하며, 여기에 플랜별 전용 월간 호출 할당량이 더해집니다 — Free/Starter에서는 0으로, 발송 API 자체가 해당 등급에서 제한되는 방식과 동일합니다.
시작하기
개발자 메뉴에서 API 키를 발급하고, 백엔드에서 등록 또는 수강 신청 엔드포인트를 호출한 다음, 임베드 토큰을 발급해 그리로 리디렉션하세요 — 전체 요청 형태는 임베드 API 퀵스타트를 참고하세요.