Reports API - 여러분의 브랜드로 제공하는 완성형 PDF 보고서 16종
당신은 생년월일을 보내면 완전한 문서를 받습니다. JSON을 받아서 PDF로 레이아웃을 구성하는 것이 아니라, 이미 레이아웃이 완료된 PDF를 받습니다. 당신의 로고, 보고서 이름, 그리고 우리에 대한 언급 없이 페이지별로 구성된 문서입니다.
이러한 보고서 21개가 이미 작동 중입니다. 대시보드, 내보내기 기록, 그리고 5개의 AI 스토리텔링과 함께 /v1/reports/* 아래에 28개의 경로가 있습니다.
카탈로그
섹션 제목: “카탈로그”각 행은 이미 완성된 샘플을 가지고 있습니다. 이것은 템플릿이 아닙니다: 이 엔드포인트의 설명서에서 인쇄된 호출과 동일한 호출로 생성된 파일이며, 템플릿과 함께 재발행됩니다.
페이지 수는 이 샘플이 제공한 수치이며, 2026년 9월 21일에 측정되었습니다 (BaZi, 숫자론, 쿠들리 호환성 및 중국년도 2026년 11월 7일). 이는 맵에 따라 변동됩니다: 더 많은 아스펙트 = 더 많은 행, relocation은 각 도시당 2~3페이지를 추가합니다 (한 도시당 4페이지, 5개 도시당 13페이지).
| 엔드포인트 | 내용 | 페이지 수 | 크레딧 | 샘플 |
|---|---|---|---|---|
/v1/reports/natal | 대삼각형, 행성, 집, 아스펙트 | 3 | 5,000 | |
/v1/reports/synastry | 두 맵 간의 아스펙트, 요소의 균형 | 2 | 5,000 | |
/v1/reports/transit-yearly | 선택한 연도의 트랜짓 예측 | 5 | 5,000 | |
/v1/reports/relocation | 출생 맵, 최대 5개 도시, 집이 바뀐 행성, 인접한 선, 19개 삶의 구 | 6 | 5,000 | |
/v1/reports/vedic-kundli | 라그나와 낙샤트라, 시데리컬 위치, 마하다시 및 빔샤토타리 | 2 | 5,000 | |
/v1/reports/lal-kitab | 키스мат, 테바, 발견된 운명, 업아이 | 2 | 5,000 | |
/v1/reports/gemstone | 추천되는 돌과 만트라, 착용하지 말아야 할 돌, 그라하 상태 | 7 | 5,000 | |
/v1/reports/human-design | 주요 매개변수, 센터, 채널 | 2 | 5,000 | |
/v1/reports/muhurta | 한 활동에 적합한 순위별 유리한 날짜 | 4 | 5,000 | |
/v1/reports/love | 주요 사랑 포인트, 대삼각형, 아스펙트 | 2 | 5,000 | |
/v1/reports/career | 주요 경력 포인트, 개인성 맥락, 아스펙트 | 2 | 5,000 | |
/v1/reports/money | 주요 금전적 포인트, 집, 아스펙트 | 3 | 5,000 | |
/v1/reports/business | 주요 비즈니스 포인트, 집, 아스펙트 | 2 | 5,000 | |
/v1/reports/child | 주요 성격 특성, 대삼각형, 행성 | 2 | 5,000 | |
/v1/reports/stellaforge | 한 페이지에 맵 포스터: 행성, 균형, 주요 아스펙트 | 1 | 5,000 | |
/v1/reports/tarot | 카드 설명 및 카드 | 2 | 100 | |
/v1/reports/vastu | 집 평면도와 만달라, 평가, 바сту 발견사항 및 원천과 수정사항 | 2 | 5,000 | |
/v1/reports/bazi | 네 개의 기둥과 신, 숨겨진 나무, 날의 주, 다섯 요소, 힘, 상징적 별, 상호작용, 행운 기둥 | 4 | 5,000 | |
/v1/reports/numerology | 여섯 주요 숫자와 해석, 균형 숫자, 나이와 관련한 정점 및 도전, 개인년도 | 3 | 5,000 | |
/v1/reports/kundli-matching | 36개의 구나 밀란, 10개의 포루탐, 망갈, 나디 및 바하쿠트 도시의 규칙, 나바姆샤, 인접한 파리의 다시 | 4 | 5,000 | |
/v1/reports/chinese-year | 당신의 동물, 연도의 기둥 및 당신의 별자리와의 관계, 동맹자, 열두 태양 달 | 3 | 5,000 |
타로는 다른 모든 보고서보다 50배 저렴합니다: 하나의 카드 레이아웃 페이지가 없으며, 천문학 계산이 없습니다.
깊이: standard 또는 extended
섹션 제목: “깊이: 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개 경로
섹션 제목: “하나의 경로 대신 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
섹션 제목: “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 예시로 렌더링됩니다. 객체에 전달된 필드는 저장된 설정보다 우선합니다.
복제 가능한 완전한 애플리케이션
섹션 제목: “복제 가능한 완전한 애플리케이션”실습용 테이블: 클라이언트 데이터는 왼쪽에, 준비된 PDF는 오른쪽에 있습니다. 각 보고서 타일은 클릭 전 크레딧 가격과 클릭 시 준비된 샘플로 연결됩니다. 화이트 레이블은 체크박스로 활성화됩니다. 백엔드는 한 개의 라우트로 구성되어 있으며, 의존성이 없습니다; 왜냐하면 그 자체가 핵심입니다: 브라우저는 직접 API에 접근할 수 없기 때문에 키는 서버에 저장됩니다.
git clone https://github.com/astroway/starter-practicecd starter-practice && npm installcp .env.example .env # your key goes herenpm run dev네 가지 중요한 사항입니다. 가격은 결정을 내리는 곳에서 표시됩니다: 서버는 X-Credits-Used를 페이지로 되돌려 보내며, 로그에만 표시하지 않습니다. 16개의 보고서는 네 가지 요청 형식을 가지고 있으며, 16개가 아닙니다. 동일한 요청은 두 번째로 호출하면 비용이 들지 않습니다; 응답 캐시가 동일한 파일을 반환하기 때문입니다. 그리고 ALLOWED_REPORTS는 인스턴스가 렌더링할 수 있는 것을 제한합니다: 공개 데모는 오직 타로 레이아웃 (/v1/reports/tarot, 100 크레딧)만 렌더링합니다; 왜냐하면 공개 인터넷 페이지가 나탈 보고서 (/v1/reports/natal, 5,000 크레딧)를 누구나 만들면 무료 월 한도가 두 클릭으로 소진되기 때문입니다.
language 필드는 21개의 코드를 받습니다. 완전히 번역된 세 가지 언어: 우크라이나어, 영어, 러시아어입니다. 나머지 18개 지역화는 별자리 이름만 번역됩니다; 제목과 설명은 영어로 남습니다: 예를 들어, 독일어 보고서는 “Leo”라는 제목 아래 “Planets”와 함께 작성됩니다.
우리는 직접 이렇게 작성합니다; 왜냐하면 보고서는 고객이 보관하는 문서이기 때문입니다. 독일어로 보고서를 판매하고, 예시에서 독일어 별자리 이름을 본 후 독일어 보고서로 판매하는 것은 고객에게 불쾌한 발견이 될 것입니다.
muhurta 보고서는 아직 완전히 영어입니다. vastu, bazi, numerology, kundli-matching, chinese-year 보고서는 우크라이나어와 영어로 작성되었습니다; 다른 언어로 요청하면 영어 문서가 반환되며, 우크라이나어 제목이 영어 데이터 위에 표시되지 않습니다. numerology의 이름은 라틴 문자로 작성하세요: 표는 A-Z만 알고 있으며, 다른 문자로 된 이름은 400 NAME_NOT_LATIN 오류를 반환합니다.
한 달에 몇 개의 보고서가 나갈 수 있는가
섹션 제목: “한 달에 몇 개의 보고서가 나갈 수 있는가”/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 수로 나눈 값입니다. 한도 초과 시, 각 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개 PDF부터 더 경제적이며, Reports Pack은 Pro보다 187개 PDF부터 더 경제적입니다. (만약 보고서 외에 다른 것이 필요하지 않다면) Business는 Reports Pack보다 367개 PDF부터 더 경제적입니다. 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을 사용하면 당신의 이름과 색상이 표준 대신에 표시됩니다.
텍스트가 필요할 때, 문서가 아닌 경우
섹션 제목: “텍스트가 필요할 때, 문서가 아닌 경우”다섯 개의 엔드포인트는 AI 스토리텔링을 JSON으로 반환하며, 레이아웃이나 PDF 없이: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. 각 250 크레딧입니다. 이를 사용하세요; 당신의 자체 레이아웃, 애플리케이션 또는 뉴스레터에 텍스트가 필요할 때입니다.
나탈 보고서는 혼합 모드를 지원합니다: enrich: true는 PDF 내부에 AI 스토리텔링을 추가합니다. 동일한 테스트 맵에서 이는 5페이지에서 3페이지로 증가합니다.