AI용 분할본 · 지도 1단계(구조·준비) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)

핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다

  1. 사용자가 결정 질문(PART 0 지침 1)에 답하고 승인하기 전에는 코드를 한 줄도 쓰지 않는다.
  2. HRUM API 키는 서버 환경변수 HRUM_API_KEY 에만 둔다. 미니앱 코드·.env·채팅·커밋·로그에 쓰지 않고, 키 값을 사용자에게 달라고 하지 않는다. 미니앱은 내 서버만 부른다.
  3. 책 코드 파일은 다시 쓰지 않는다 — node scripts/get-book-code.mjs 가 책 그대로 만든다(처음에는 부록 A-2 의 curl 한 줄). 분할본의 코드 자리는 「경로」 한 줄이다 — 받은 파일을 cat 으로 읽는다.
  4. 앱인토스 내용은 각 장 끝 출처의 공식 문서가 우선이다. 다르면 문서를 따르고 사용자에게 알린다.
  5. 확인은 명령 출력으로 증명한다. 콘솔 화면(앱인토스·HRUM)은 사용자가 누르고, AI 는 대신 가입·로그인하지 않는다. 진행은 PROGRESS.md 에 적는다.
  6. AI 는 지도(https://console.hrum.ai/tossEbook/ — 같은 지도가 tossEbook/ai.html 에도 있다)의 단계 순서대로 그 단계의 페이지만 읽는다. 전체본 tossEbook.html 은 사람용이다.

PART 1 — 무엇을 만들고, 왜 서버가 필요한가

1-1. 한 장으로 보는 구조

요청이 흐르는 길
토스 앱
  └ 미니앱 번들 (<appName>.ait — 화면만, 키 없음)
       │  POST https://<이름>.ridm.ai/api/today   (생년월일)
       ▼
  내 서버 (RIDM Apps — HRUM_API_KEY 를 환경변수로 보관)
       │  POST https://api.hrum.ai/api/v1/partners/v1/today
       │  X-Partner-Api-Key: (서버만 아는 키)
       ▼
  HRUM 오늘의 사주 API → 결과 → 서버가 필요한 칸만 골라 미니앱에 돌려줌

미니앱 번들은 미니앱을 여는 모든 휴대폰에 내려가는 파일입니다. 그 안에 든 것은 누구나 꺼내 볼 수 있다고 봐야 합니다. HRUM 시작 가이드도 키는 서버에서만 쓰고, 브라우저나 앱 코드에 넣으면 누구나 꺼내 쓸 수 있다고 안내합니다. 그래서 이 책은 키를 서버에만 두고, 미니앱은 내 서버 주소만 압니다.

1-2. 앱인토스 쪽 구조 — 이 책이 쓰는 것

앱인토스 「시작하기」 문서에 따르면 앱인토스는 클라이언트 SDK 와 서버 API 두 방식으로 연동합니다. SDK 는 토스 앱 안 미니앱 실행 환경을 만들고, 서버 API 는 로그인·결제처럼 파트너 서버와 앱인토스 서버가 직접 주고받는 기능(mTLS 로 보호)을 맡습니다. SDK 는 WebView SDK 와 React Native SDK 중 하나를 고릅니다.

1-3. 만들어지는 앱

1-4. 시작 전에 알아야 할 앱인토스 정책 요점

항목문서 내용 요약이 책의 예시
로그인미니앱 안 로그인은 토스 로그인만 쓸 수 있고, 다른 로그인·소셜 로그인은 쓸 수 없음(서비스 오픈 정책 2-3)로그인 없음
결제실물 상품은 토스페이만, 디지털 상품은 인앱 결제만(2-3)결제 없음
광고앱인토스 전면형·보상형·배너 광고만, 외부 광고 네트워크는 불가(2-3)광고 없음
외부 링크·자사 앱 설치 유도앱 설치 유도 불가, 외부 링크는 허용된 경우에만. 콘솔에 적은 「앱 내 기능」은 미니앱 안에서 완결돼야 함(2-2)외부 링크 없음, 결과까지 미니앱 안에서 끝남
생성형 AIAI 가 만든 결과를 보여 주면 처음 쓸 때 고지하고 결과에 AI 표시를 해야 함(2-4)규칙 계산 값만 씀. HRUM 의 LLM 한 줄 옵션(llm: true)을 켜면 고지·표시를 넣어야 함
중복 앱같은 워크스페이스에서 핵심 기능이 비슷한 앱을 여러 개 낼 수 없음(2-1)앱 하나
단순 홍보기존 회사·서비스를 단순히 홍보하려고 미니앱을 낼 수 없음(3장)운세 결과가 미니앱의 기능
사업자 등록필수는 아니지만 토스 로그인·인앱 결제·토스페이·프로모션·비즈 월렛에는 필수. 인앱 광고는 등록 없이 시작할 수 있고, 수익이 일정 금액을 넘으면 필요. 부가세 면세 사업자는 등록 불가(사업자 등록하기)해당 기능을 쓰지 않음
이용 연령지금 앱인토스는 만 19세 이상 사용자에게만 제공(미니앱 등록하기)—

출시가 안 되는 서비스(금융·투자 정보·의료·사행성·정치 등)와 조건이 붙는 서비스 목록은 「서비스 오픈 정책」 원문에 있습니다. 정책은 바뀔 수 있으니 등록 전에 원문을 다시 봅니다.

출처

앱인토스 내용은 2026-10-28 에 앱인토스 개발자센터 문서를 직접 읽고 요약했고, 2026-10-30 에 문서와 다시 대조했습니다. 정책·화면은 바뀔 수 있으니 시작 전에 원문을 다시 확인하세요.

AI용 분할본 · 지도 1단계(구조·준비) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)