Reports API - 여러분의 브랜드로 제공하는 완성형 PDF 보고서 16종

Last updated 2026년 11월 7일 Markdown으로 보기 에이전트 설정

당신은 생년월일을 보내면 완전하게 포맷된 문서를 받습니다. JSON이 아닌, PDF로 직접 레이아웃이 구성된 문서입니다. 당신의 로고, 보고서 이름, 그리고 우리에 대한 언급 없이 페이지별로 구성됩니다.

16개의 보고서가 이미 작동 중입니다. 관리자, 내역, 그리고 5개의 AI 스토리까지 합쳐서 /v1/reports/* 아래에 23개의 경로가 있습니다.

카탈로그

각 행에는 완전한 샘플이 있습니다. 이것은 템플릿이 아닙니다: 해당 엔드포인트의 호출로 생성된 파일이며, 문서와 함께 템플릿과 함께 재발행됩니다.

페이지 수는 2026년 9월 21일에 측정된 해당 샘플의 페이지 수입니다. 이는 지도에 따라 변동됩니다: 더 많은 아스펙트가 더 많은 행을 의미하며, relocation은 각 도시당 2~3페이지 추가합니다 (한 도시당 4페이지, 5개 도시당 13페이지).

엔드포인트	내용	페이지 수	크레딧	샘플
`/v1/reports/natal`	대삼각형, 행성, 집, 아스펙트	3	5,000	PDF
`/v1/reports/synastry`	두 지도 간의 아스펙트, 원소 균형	2	5,000	PDF
`/v1/reports/transit-yearly`	선택한 해의 트랜짓 예측	5	5,000	PDF
`/v1/reports/relocation`	출생 지도, 최대 5개의 도시, 집이 바뀐 행성, 근처의 선, 19개의 삶의 구	6	5,000	PDF
`/v1/reports/vedic-kundli`	라그나와 낙샤트라, 시데리컬 위치, 마하다시 비무슈타리	2	5,000	PDF
`/v1/reports/lal-kitab`	키스мат, 테바, 발견된 운명, 업아이	2	5,000	PDF
`/v1/reports/gemstone`	추천되는 돌과 마ント라, 어떤 돌을 입지 말아야 하는지, 그라하 상태	7	5,000	PDF
`/v1/reports/human-design`	주요 매개변수, 센터, 채널	2	5,000	PDF
`/v1/reports/muhurta`	하나의 활동에 적합한 순위별 유익한 날짜	4	5,000	PDF
`/v1/reports/love`	주요 사랑의 점, 대삼각형, 아스펙트	2	5,000	PDF
`/v1/reports/career`	주요 경력 점, 개인적 맥락, 아스펙트	2	5,000	PDF
`/v1/reports/money`	주요 금전적 점, 집, 아스펙트	3	5,000	PDF
`/v1/reports/business`	주요 사업 점, 집, 아스펙트	2	5,000	PDF
`/v1/reports/child`	주요 성격 특성, 대삼각형, 행성	2	5,000	PDF
`/v1/reports/stellaforge`	한 페이지의 지도 포스터: 행성, 균형, 주요 아스펙트	1	5,000	PDF
`/v1/reports/tarot`	카드 설명과 카드	2	100	PDF
`/v1/reports/vastu`	집 평면도와 만달라, 평가, 바스트우 발견사항 및 원인 및 수정 사항	2	5,000	PDF

타로는 다른 것들과 달리 50배 저렴합니다. 왜냐하면 타로는 천문학적 계산이 필요하지 않기 때문입니다. 한 페이지의 카드 설명이 천문학적 계산 없이 제공되기 때문입니다.

깊이: standard 또는 extended

/v1/reports/natal (및 report_type: "natal"인 /v1/reports/generate)은 depth를 받습니다. standard는 위와 같은 문서이며, 5,000 크레딧입니다. extended는 10,000 크레딧이며, 태양부터 플루토, 히론, 그리고 승월까지의 각 천체에 대해 별도의 섹션을 추가합니다: 총 12개의 섹션, 각 섹션은 2~4페이지의 편집된 텍스트로 구성됩니다 (PDF 예시, 13페이지). /v1/natal-texts에서 제공하는 동일한 콘텐츠로 구성됩니다. 요청에 의해 생성되는 것은 아무것도 없습니다. 따라서 같은 지도도 같은 문서를 제공합니다.

섹션은 20개 언어로 제공되며, 사이트의 언어와 같습니다. depth: "extended"와 다른 언어로 요청하면 400에러가 발생하며, 다른 언어로 대체되지 않습니다. 다른 보고서 유형은 아직 하나의 깊이만 지원합니다: 그들의 긴 섹션은 아직 작성되지 않았습니다.

하나의 경로 대신 16개

POST /v1/reports/generate은 report_type 필드를 받아서 개별 경로와 동일한 작업을 수행합니다. 12개의 유형이 있습니다: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

SDK에 있어서는 12개의 메서드 대신 하나의 메서드, MCP에 있어서는 12개의 도구 대신 하나의 도구입니다. 가격은 동일합니다: 관리자를 통해 호출하면 직접 경로와 동일한 금액이 차감됩니다.

PDF, HTML 또는 Markdown

각 보고서 유형과 관리자도 format을 받습니다: 요청 본문 또는 ?format= 쿼리 파라미터로 (한 번만 전송; 두 가지 다른 값은 400에러를 반환합니다). 모든 세 가지 포맷의 가격은 동일합니다. 왜냐하면 당신은 문서에 지불하고, 그 문서가 어떤 파일 형식으로 전달되느냐에 따라 지불하지 않기 때문입니다.

`format`	반환되는 내용	저장 여부
`pdf` (기본값)	`url`, `page_count`, `expires_at`가 포함된 JSON	24시간 또는 `retain_days`
`html`	문서 자체, `Content-Type: text/html`	저장되지 않음
`markdown`	동일한 문서가 Markdown 형식으로, `Content-Type: text/markdown`	저장되지 않음

HTML은 하나의 자체 완결형 파일입니다: 스타일은 내장되어 있으며, 지도 바퀴와 바스트우 평면도는 내장된 SVG로 제공됩니다. 스크립트나 외부 폰트는 없습니다. 이것은 PDF로 인쇄되는 동일한 페이지이며, 동일한 화이트 레이블 블록을 포함합니다: 회사 이름, 보고서 이름, 색상 및 푸터. 유일한 외부 링크는 당신의 logoUrl이며, 이는 여전히 https 이미지로의 링크로 남아있습니다. PDF와 마찬가지로. 각 이름, 위치, 그리고 텍스트는 에스케이프 처리되어 <img onerror=...>와 같은 이름도 텍스트로 출력됩니다. 문서를 자신의 페이지나 iframe에 삽입할 수 있습니다.

Markdown은 동일한 제목, 텍스트, 그리고 표를 포함합니다. 제목 레벨은 보존됩니다: #은 보고서 이름, ##은 섹션, ###은 하위 섹션이며, PDF와 동일한 순서로 구성됩니다. 따라서 ## 으로 시작하는 행으로 분할하면 섹션이 생성됩니다. GitHub 형식의 표입니다. 이미지(바퀴, 평면도)는 생략되며, 그 자리에 한 줄의 주석이 표시됩니다. Markdown 또는 HTML 렌더러가 읽어들일 수 있는 모든 문자가 역슬래시로 에스케이프 처리됩니다.

curl -X POST "https://api.astroway.info/v1/reports/natal?format=markdown" \
  -H "X-Api-Key: aw_live_..." -H "Content-Type: application/json" \
  -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00",
                   "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
        "language": "uk" }'

PDF 링크는 24시간 동안 유효합니다. 클라이언트에게 더 긴 유효기간의 링크를 제공하려면 ?retain_days=30 (최대 90일)을 추가하세요: 파일은 해당 일수 동안 저장되며, 응답의 expires_at는 이를 표시합니다. 무제한 호스팅은 제공하지 않습니다. 파일은 더 일찍 삭제할 수 있으며, DELETE /v1/reports/files/{filename}을 통해 무료로 삭제할 수 있습니다. 파일은 당신이 보낸 내용과 함께 이름도 포함되어 있으므로, 저장 기간은 DPA의 2절에 설명되어 있습니다. /v1/reports/history는 무료로 마지막 내역을 보여주고, 만료된 기록은 expired: true로 표시됩니다.

당신의 브랜드, 아닌 우리의

whitelabel은 15개의 필드를 가진 객체를 받습니다: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing 그리고 다섯 가지 색상 (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

이 객체를 직접 요청에 전달할 수 있으며, 그러면 계정 설정은 필요 없습니다:

curl -X POST https://api.astroway.info/v1/reports/natal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00",
                   "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
        "whitelabel": { "companyName": "Zoryana Studio",
                        "reportName": "Your Birth Blueprint",
                        "themeColor": "#7c3aed",
                        "footerText": "zoryana.example" } }'

생성된 문서에는 스튜디오 이름, 보고서의 제목, 섹션 제목의 강조 색상, 그리고 푸터가 포함됩니다. 문서에는 AstroWay라는 단어가 단 한 번도 없습니다.

계정 설정에서 객체를 반복적으로 전달하고 싶지 않은 경우: whitelabel: true는 저장된 계정 구성으로 설정됩니다. 이를 설정하려면 대시보드의 보고서 브랜딩 페이지에서: 회사 이름, 보고서 이름, 연락처, 로고, 그리고 두 가지 색상을 설정하세요. 예시로 나탈 보고서의 미리보기를 볼 수 있습니다. 동일한 설정은 키를 통해 /v1/whitelabel/config와 /v1/whitelabel/logo를 통해 접근할 수 있으며, POST /v1/whitelabel/preview는 PDF 예시로 렌더링됩니다. 객체에 전달된 필드는 저장된 설정보다 우선합니다.

복제 가능한 완전 응용 프로그램

라이브 데모와 GitHub 코드, MIT 라이선스.

실습자용 테이블: 클라이언트 데이터는 왼쪽에, 완전한 PDF는 오른쪽에 있습니다. 각 보고서 타일은 클릭 전 크레딧 비용을 표시하고, 완전한 예시로 연결됩니다. 화이트 레이블은 체크박스로 활성화됩니다. 백엔드는 한 개의 경로로 구성되어 있으며, 의존성이 없습니다. 왜냐하면 그 자체가 핵심이기 때문입니다: 브라우저는 API에 직접 접근할 수 없기 때문에 키는 서버에 저장됩니다.

git clone https://github.com/astroway/starter-practice
cd starter-practice && npm install
cp .env.example .env     # your key goes here
npm run dev

네 가지 중요한 사항입니다. 가격은 결정을 내리는 곳에서 표시됩니다: 서버는 X-Credits-Used를 페이지로 반환하며, 로그에만 표시되지 않습니다. 16개의 보고서는 네 가지 요청 형식을 가지고 있으며, 16개가 아닙니다. 동일한 요청을 두 번째로 보내면 비용이 발생하지 않으며, 응답 캐시가 동일한 파일을 반환하기 때문입니다. 그리고 ALLOWED_REPORTS는 인스턴스가 렌더링할 수 있는 것을 제한합니다: 공개 데모는 오직 타로 카드 예시 (/v1/reports/tarot, 100 크레딧)만 렌더링합니다. 왜냐하면 공개 웹 페이지가 나탈 보고서 (/v1/reports/natal, 5,000 크레딧)를 누구나 생성하면 무료 한도가 두 클릭으로 소진되기 때문입니다.

언어

language 필드는 21개의 코드를 받습니다. 완전히 번역된 세 가지 언어는 다음과 같습니다: 한국어, 영어, 러시아어. 나머지 18개 언어는 별자리 이름만 번역됩니다. 제목과 설명은 영어로 남습니다: 예를 들어, 독일어 보고서는 “Löwe”라는 제목 아래 “Planets”로 표시됩니다.

우리는 직접 이렇게 작성합니다. 왜냐하면 보고서는 고객이 보관하는 문서이기 때문입니다. 독일어로 보고서를 판매하면서 독일어 별자리 이름을 예시에서 확인하는 것은 고객 측에서 불쾌한 발견이 될 것입니다.

muhurta 보고서는 현재 완전히 영어입니다.

한 달에 몇 개의 보고서가 가능할까?

/v1/reports/natal과 나머지 PDF는 5,000 크레딧이므로, 월별 한도는 PDF 수로 쉽게 변환됩니다:

플랜	크레딧/월	PDF 보고서	타로 보고서
Free	10,000	불가능	불가능
Indie, $5	50,000	10	500
Starter, $19	200,000	40	2,000
Pro, $59	800,000	160	8,000
Business, $199	3,500,000	700	35,000
Reports Pack, $99	1,500,000	300	15,000

Free 플랜에서 보고서는 의도적으로 닫혀 있습니다: 각 PDF는 우리의 측에서 렌더링되는 몇 초가 소요되기 때문에 무료 타리프는 이를 커버하지 않습니다. 가장 저렴한 시작은 $5의 Indie입니다.

Reports Pack은 보고서만 필요한 사람들에게 별도의 추가 서비스입니다: $99/월, 1,500,000 크레딧, 즉 33센트당 300개의 PDF와 화이트 레이블이 포함됩니다. 이것은 Pro 플랜의 PDF보다 저렴합니다. 왜냐하면 키가 보고서 외에는 사용되지 않기 때문입니다. 이러한 플랜의 키는 /v1/reports/*와 /v1/whitelabel/*에서만 사용됩니다.

보고서의 재판매: PDF당 얼마가 들까?

당신이 고객에게 보고서를 판매한다면, 중요한 것은 한 가지 숫자입니다: 당신의 규모에서 한 개의 PDF가 당신에게 얼마가 드는지입니다. 플랜 한도의 범위 내에서, 이는 플랜 가격이 PDF 수로 나눈 값입니다. 한도 초과 시, 각 PDF는 초과한 10,000 크레딧당 과금되며, 5,000 크레딧의 PDF는 과금률의 절반 가격입니다.

플랜	플랜 내 PDF	플랜 내 PDF 가격	한도 초과 시 PDF
Indie, $5	10	$0.50	$2.50
Starter, $19	40	$0.48	$2.50
Pro, $59	160	$0.37	$1.50
Reports Pack, $99	300	$0.33	$1.50
Business, $199	700	$0.28	$1.00

따라서 가장 저렴한 플랜은 월간 판매하는 PDF 수에 따라 달라집니다. 과금률을 포함하여:

PDF/월	가장 저렴한 플랜	당신의 비용	PDF당
10	Indie	$5	$0.50
40	Starter	$19	$0.48
100	Pro	$59	$0.59
160	Pro	$59	$0.37
300	Reports Pack	$99	$0.33
500	Business	$199	$0.40
700	Business	$199	$0.28

변경 지점: Starter는 Indie보다 16개의 PDF부터 더 유리하며, Pro는 Starter보다 57개부터 더 유리합니다. Reports Pack는 Pro보다 187개부터 더 유리하며, 보고서 외에는 아무것도 필요하지 않으면 Business는 Reports Pack보다 367개부터 더 유리합니다. Pro와 Business는 추가로 다른 API를 개방하며, Pack은 보고서와 화이트 레이블만 제공합니다.

마진은 당신이 정합니다. Reports Pack에서 300개의 PDF를 판매한다면, 당신의 월간 비용은 $99입니다. $9당 $2,700의 수익과 $99의 비용, $19당 $5,700의 수익이 됩니다. 소매 가격을 추천하지 않지만, 수학은 동일합니다: 당신의 가격에서 33센트를 뺍니다.

확장된 나탈 보고서는 표준보다 두 배 비싸므로, 모든 플랜에서 PDF 가격은 두 배입니다: Reports Pack에서는 $0.66입니다.

두 가지 요소가 실제 비용을 더 낮춥니다. 동일한 데이터로 두 번째 요청은 캐시된 파일을 반환하여 비용이 발생하지 않으므로, 두 번 다운로드한 클라이언트는 한 번만 지불합니다. 그리고 연간 플랜은 9할 가격으로 12개월을 제공하며, Reports Pack는 PDF당 $0.25로 제공됩니다.

판매하기 전에 예시를 확인하세요: 각 예시는 API가 반환하는 실제 파일이며, whitelabel을 사용하면 당신의 이름과 색상이 표준 대신에 표시됩니다.

텍스트가 필요할 때, 문서가 아닌

다섯 개의 엔드포인트는 JSON으로 AI 스토리를 반환하며, 레이아웃이나 PDF 없이: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. 각 250 크레딧입니다. 당신의 자체 레이아웃, 애플리케이션 또는 이메일 발송에 텍스트가 필요한 경우 사용하세요.

나탈 보고서는 혼합 모드를 지원합니다: enrich: true는 PDF 내부에 AI 스토리를 추가합니다. 동일한 테스트 카드에서 5페이지가 3페이지에서 5페이지로 확장됩니다.