퀵스타트
임베드 API를 사용하면 자신의 백엔드에서 자신의 최종 사용자를 MailInApp 강좌나 웨비나에 등록하거나 참가시키고, 시청/참여 경험을 자신의 앱에 임베드할 수 있습니다 — 그 최종 사용자가 MailInApp 대시보드 계정을 건드릴 일은 전혀 없습니다. 트랜잭션 Send API와 동일한 베어러 API 키를 공유하므로 새로 발급받을 자격 증명이 없습니다.
키 발급
다른 모든 곳과 동일한 키입니다 — 대시보드의 개발자 메뉴에서 키 생성을 클릭하세요. 전체 키(mia_live_...)는 정확히 한 번만 표시되며, MailInApp은 해시만 보관합니다. 하나의 키로 아래에 나오는 것들을 포함해 계정의 모든 경로를 호출할 수 있습니다.
웨비나 참가자 등록하기
공개 등록 웨비나에 최종 사용자를 등록하고 참여 링크를 반환합니다 — MailInApp 폼도, 사용자를 위한 MailInApp 계정도 필요하지 않습니다.
curl -X POST https://mailinapp.com/api/v1/webinars/<liveSessionId>/register \
-H "Authorization: Bearer mia_live_..." \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"name": "Ada Lovelace"
}'
성공적인 호출은 확정된 참여 링크 또는 대기자 상태 중 하나를 반환합니다.
{ "status": "confirmed", "joinUrl": "https://mailinapp.com/webinar/.../join?token=..." }
웨비나 자체는 동일한 방식으로 생성합니다 — POST /api/v1/webinars — 또는 대시보드의 라이브에서 이미 만든 것을 재사용할 수 있습니다. 어느 쪽이든 accessMode: "registration"이어야 합니다. 전체 요청/응답 형태는 API 레퍼런스를 참고하세요.
웨비나의 liveSessionId는 라이브 & 웨비나의 해당 페이지, 라이프사이클 이메일 아래쪽에 복사 버튼과 함께 있습니다.
강좌 구독자 등록하기
이메일 주소에 대해 강좌 접근 권한을 부여하거나(또는 회수합니다) — 누가 자격이 있는지는 자신의 결제나 체크아웃 시스템이 결정하며, MailInApp은 강좌를 렌더링만 합니다.
curl -X POST https://mailinapp.com/api/v1/courses/<courseId>/enroll \
-H "Authorization: Bearer mia_live_..." \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"active": true
}'
{ "subscriberId": "abc123", "active": true }
강좌의 courseId는 강좌의 해당 페이지, 라이프사이클 이메일 아래쪽에 복사 버튼과 함께 있습니다. 그 주소로는 회원 포털의 강좌 링크가 담긴 등록 이메일이 발송되며, 수강생은 같은 주소로 로그인합니다. 대신 스튜디오에서 만든 이메일을 보내려면 라이프사이클 이메일에서 수강 신청에 선택하세요.
강좌 뷰어 임베드하기
구독자가 등록되면, 단기(5분) 서명 토큰을 발급받아 앱의 iframe이나 창을 반환된 URL로 리디렉션하세요.
curl -X POST https://mailinapp.com/api/v1/courses/<courseId>/embed-token \
-H "Authorization: Bearer mia_live_..." \
-H "Content-Type: application/json" \
-d '{ "email": "[email protected]" }'
{ "portalUrl": "https://mailinapp.com/learn/<slug>/courses/<courseId>/embed?token=..." }
portalUrl을 열면 방문자가 토큰을 교환하는 부트스트랩 페이지에 로그인되고, 직접 등록된 구독자가 받는 것과 동일한 강좌 포털 — 동영상, 진행률, 퀴즈 — 로 이동합니다. 이 작업이 성공하려면 강좌가 published 상태여야 하고, 계정이 이미 멤버십 슬러그(/learn/<slug>)를 확보해 두었어야 합니다.
진짜 차별점: 인터랙티브 라이프사이클 이메일
등록, 리마인더, 수강 신청, 완료 이메일은 여전히 모두 발송됩니다 — 기본적으로는 지금과 같은 단순한 확인 문구로 발송됩니다. 대시보드의 강좌 또는 웨비나 자체 설정 패널에 새로 추가된 라이프사이클 이메일 섹션을 사용하면, 이런 이벤트 각각을 하드코딩된 문자열 대신 스튜디오에서 만든 프로젝트로 연결할 수 있습니다. 그러면 발송되는 이메일이 전체 폴백 엔진(키네틱 블록, 병합 태그, 라이브 뷰)을 통해 렌더링됩니다. 연결하지 않은 이벤트는 아무것도 달라지지 않습니다.