Reports API - 16 gotowych raportów PDF pod Twoją marką
Wyślijesz datę urodzenia, a otrzymasz gotowy dokument. Nie JSON, z którego trzeba będzie skomponować PDF, tylko sam PDF: paginowany, z Twoim logo, nazwą raportu i bez jakiejkolwiek wzmianki o nas wewnątrz.
Sześćnaście takich raportów już działa. Razem z dyspozytorem, historią eksportów i pięcioma AI-narracjami to 23 ścieżki pod /v1/reports/*.
Katalog
Dział zatytułowany „Katalog”Każdy wiersz zawiera gotowy przykład. To nie szablon: plik został wygenerowany tym samym wywołaniem, które jest opisane w dokumentacji tego endpointu, i jest ponownie wydawany wraz z szablonami.
Liczba stron to ta, którą dał ten konkretny przykład, zmierzona 2026-09-21. Może się zmieniać w zależności od mapy: więcej aspektów oznacza więcej wierszy, a relocation dodaje po dwie-trzy strony na każde miasto (4 strony dla jednego miasta, 13 dla pięciu).
| Endpoint | Co jest wewnątrz | Stron | Kredytów | Przykład |
|---|---|---|---|---|
/v1/reports/natal | Wielka Trójka, planety, domy, aspekty | 3 | 5 000 | |
/v1/reports/synastry | Międzykartowe aspekty dwóch map, bilans elementów | 2 | 5 000 | |
/v1/reports/transit-yearly | Prognoza tranzytów na wybrany rok | 5 | 5 000 | |
/v1/reports/relocation | Mapa wyjściowa, do 5 miast, planety które zmieniły dom, linie obok, 19 sfer życia | 6 | 5 000 | |
/v1/reports/vedic-kundli | Lagna i nakshatra, syderyczne pozycje, mahadashi Vimshottari | 2 | 5 000 | |
/v1/reports/lal-kitab | Kismet, tewa, wykryte rany, upayi | 2 | 5 000 | |
/v1/reports/gemstone | Rekomendacja kamieni z mantrami, kamienie których nie nosić, stan graha | 7 | 5 000 | |
/v1/reports/human-design | Kluczowe parametry, centra, kanały | 2 | 5 000 | |
/v1/reports/muhurta | Uporzządkowane sprzyjające dni pod jedną aktywność | 4 | 5 000 | |
/v1/reports/love | Kluczowe punkty miłości, Wielka Trójka, aspekty | 2 | 5 000 | |
/v1/reports/career | Kluczowe punkty kariery, kontekst osobowości, aspekty | 2 | 5 000 | |
/v1/reports/money | Kluczowe finansowe punkty, domy, aspekty | 3 | 5 000 | |
/v1/reports/business | Kluczowe punkty biznesu, domy, aspekty | 2 | 5 000 | |
/v1/reports/child | Kluczowe cechy charakteru, Wielka Trójka, planety | 2 | 5 000 | |
/v1/reports/stellaforge | Poster mapy na jedną stronę: planety, bilans, kluczowe aspekty | 1 | 5 000 | |
/v1/reports/tarot | Opis rozkładu i karty | 2 | 100 | |
/v1/reports/vastu | Plan domu z mandalą, ocena, znaleziska Vastu z źródłami i poprawkami | 2 | 5 000 |
Tarot kosztuje pięćdziesiąt razy mniej, ponieważ nie ma efemeryd: jedna strona rozkładu bez astronomicznych obliczeń.
Głębokość: standard lub extended
Dział zatytułowany „Głębokość: standard lub extended”/v1/reports/natal (i /v1/reports/generate z report_type: "natal") przyjmuje depth. standard to dokument wyżej, 5000 kredytów. extended kosztuje 10000 kredytów i dodaje koło mapy oraz sekcję dla każdego z ciał od Słońca do Plutona, Chirona i Wschodzącego Znaku w znaku: dwanaście sekcji, każda na dwie-cztery strony edytowanego tekstu (przykład PDF, 13 stron) z tego samego zbioru, który dostarcza /v1/natal-texts. Nic nie jest generowane pod żądanie, więc ta sama mapa daje ten sam dokument.
Sekcje są w 20 językach, językami strony; depth: "extended" z innym językiem odrzuca się z 400, a nie jest wypełniany z innego języka. Pozostałe typy raportów mają obecnie jedną głębokość: ich długie sekcje jeszcze nie zostały napisane.
Jedna ścieżka zamiast szesnastu
Dział zatytułowany „Jedna ścieżka zamiast szesnastu”POST /v1/reports/generate przyjmuje pole report_type i wykonuje to samo, co osobny endpoint. Dwanaście typów: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.
Dla SDK jest to jeden metod zaamiast dwunastu, dla MCP jeden narzędzie zamiast dwunastu. Cena jest taka sama: wywołanie przez dyspozytora pobiera dokładnie tyle, ile bezpośredni endpoint.
PDF, HTML czy Markdown
Dział zatytułowany „PDF, HTML czy Markdown”Każdy typ raportu, oraz dyspozytor również, przyjmuje format: w ciele żądania lub jako ?format= w linii żądania (prześlij raz; dwa różne wartości dają 400). Cena jest taka sama we wszystkich trzech, ponieważ płacisz za dokument, a nie za plik, w którym on przychodzi.
format | Co jest zwracane | Zapisywane |
|---|---|---|
pdf (domyślnie) | JSON z url PDF, page_count i expires_at | 24 godziny lub retain_days |
html | Sam dokument, Content-Type: text/html | nie zapisywane |
markdown | Ten sam dokument w Markdown, Content-Type: text/markdown | nie zapisywane |
HTML to jeden samodzielny plik: style wewnątrz, koło mapy i plan Vastu jako wbudowany SVG, bez skryptów i bez zewnętrznych czcionek. To ta sama strona, z której drukuje się PDF, z tym samym białym etykietowaniem: nazwa firmy, nazwa raportu, kolory i stopka. Jedyne zewnętrzne linki to Twój logoUrl, pozostaje on linkiem do Twojego obrazu HTTPS, tak samo jak w PDF. Każde imię, miejsce i tekst, które przesyłasz, są ekranowane, więc imię takie jak <img onerror=...> jest drukowane jako tekst. Dokument można wstawić na swoją stronę lub w iframe.
Markdown ma te same nagłówki, tekst i tabelki. Poziomy nagłówków są zachowane: # to nazwa raportu, ## sekcja, ### podsekcja, w tym samym porządku co w PDF, więc podział według wierszy zaczynających się od ## , daje sekcje. Tabelki w formacie GitHub. Rysunek (koło, plan) jest pomijany, na jego miejscu jeden wiersz z notką. Każdy znak, który Markdown lub renderowanie z HTML wewnątrz odczytałoby jako znacznik, jest ekranowany odwrotną ukośnikiem.
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" }'Link do PDF żyje 24 godziny. Aby przekazać klientowi link na dłużej, dodaj ?retain_days=30 (do 90): plik będzie leżał tyle dni, a expires_at w odpowiedzi to pokaże. Bezterminowo nie hostujemy cudzych dokumentów, a usunięcie pliku wcześniej można zrobić przez DELETE /v1/reports/files/{filename}, za darmo. Plik zawiera to, co przesłałeś, wraz z nazwą, więc okres przechowywania jest opisany w DPA, rozdział 2. GET /v1/reports/history za darmo pokazuje ostatnie eksporty tego klucza, a przeterminowany rekord przychodzi z expired: true.
Twój brand, nie nasz
Dział zatytułowany „Twój brand, nie nasz”whitelabel przyjmuje obiekt z 15 pól: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing i pięć kolorów (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).
Możesz go przekazać bezpośrednio w żądaniu, i wtedy nie będzie potrzebnych żadnych ustawień konta:
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" } }'W wygenerowanym dokumencie nazwa studia, własny tytuł raportu, kolor akcentu w nagłówkach sekcji i Twój stopka. Słowa AstroWay w nim nie występują ani razu.
Alternatywa dla tych, którzy nie chcą powtarzać obiektu w każdym żądaniu: whitelabel: true pobiera zapisane ustawienia konta. Ustaw je na stronie Branding raportów w panelu: nazwa firmy, nazwa raportu, kontakty, logo i dwa kolory, z prewizją przykładu raportu urodzinowego. Te same ustawienia są dostępne z kluczem przez /v1/whitelabel/config i /v1/whitelabel/logo, a POST /v1/whitelabel/preview rysuje przykład w PDF. Pole, które zostało przekazane w obiekcie, ma priorytet nad zapisany.
Gotowe rozwiązanie, które można sklonować
Dział zatytułowany „Gotowe rozwiązanie, które można sklonowa支ywe demo i kod na GitHub, MIT.
Stół praktyka: dane klienta z lewej strony, gotowy PDF z prawej. Każda płytka raportu pokazuje cenę w kredytach przed kliknięciem i prowadzi do gotowego przykładu. White-label włącza się za pomocą zaznaczenia. Backend to jedna ścieżka bez zależności, ponieważ właśnie w niej tkwi istota: przeglądarka nie może się bezpośrednio połączyć z API, więc klucz żyje na serwerze.
git clone https://github.com/astroway/starter-practicecd starter-practice && npm installcp .env.example .env # your key goes herenpm run devCztery rzeczy, które warto zabrać. Cena jest pokazywana tam, gdzie podejmuje się decyzję: serwer zwraca X-Credits-Used z powrotem na stronę, a nie tylko w logu. Szesnaście raportów ma cztery formy żądania, a nie szesnaście. Ten sam żądanie po raz drugi kosztuje zero, ponieważ cache odpowiedzi zwraca ten sam plik. I ALLOWED_REPORTS ogranicza, co konkretna instancja zgodzi się renderować: publiczne demo renderuje tylko rozkład Tarota (/v1/reports/tarot, 100 kredytów), ponieważ strona w otwartym internecie, która generuje raport urodzinowy (/v1/reports/natal, 5 000) dla kogoś, ktoś, ktoś zużywa miesięczny bezpłatny limit za dwa kliknięcia.
Pole language przyjmuje 21 kod. Pełne tłumaczenia są dostępne dla trzech: ukraińskiego, angielskiego, rosyjskiego. Pozostałe osiemnaście lokalizacji tłumaczy tylko nazwy znaków, a nagłówki i wyjaśnienia pozostają angielskie: niemiecki raport napisze “Löwe” pod nagłówkiem “Planety”.
Piszę to bezpośrednio, ponieważ raport to dokument, który Twój klient zostawia sobie. Sprzedanie go jako niemiecki, widząc niemieckie nazwy znaków w przykładzie, byłoby nieprzyjemnym odkryciem po stronie klienta, a nie naszej. Raport muhurta nadal jest całkowicie angielski.
Ile raportów wyjdzie na planie
Dział zatytułowany „Ile raportów wyjdzie na planie”/v1/reports/natal i pozostałe PDF-y kosztują 5 000 kredytów, więc miesięczny limit planu przekłada się na liczbę raportów bezpośrednio:
| Plan | Kredytów/miesiąc | PDF-raportów | Tarot-raportów |
|---|---|---|---|
| Free | 10 000 | raporty niedostępne | niedostępne |
| 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 |
Na Free raporty są zamknięte celowo: każdy PDF to sekundy renderowania po naszej stronie, a bezpłatny tarif ich nie pokrywa. Najtańszy wejście to Indie za $5.
Reports Pack to oddzielny dodatek dla tych, którzy potrzebują tylko raportów: $99 na miesiąc, 1 500 000 kredytów, czyli 300 PDF po 33 centów za sztukę, z white-label. Jest to tańsze niż PDF na Pro, ponieważ klucz nie idzie nigdzie poza raporty. Klucz takiego planu działa tylko w /v1/reports/* i /v1/whitelabel/*.
Przekupstwo raportów: ile kosztuje Cię PDF
Dział zatytułowany „Przekupstwo raportów: ile kosztuje Cię PDF”Jeśli sprzedajesz raporty swoim klientom, ważne jest jedno число: ile kosztuje jeden PDF na Twoim obiegu. W ramach limitu planu to cena planu, podzielona przez liczbę PDF. Ponad limit każdy PDF idzie jako nadwyżka, która jest obliczana za każde 10 000 kredytów ponad limit, więc PDF za 5000 kredytów kosztuje połowę stawki nadwyżki planu.
| Plan | PDF w planie | Cena PDF w ramach | Każdy PDF ponad |
|---|---|---|---|
| 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 |
Zatem najtańszy plan zależy od tego, ile PDF na miesiąc sprzedajesz, włączając nadwyżkę:
| PDF na miesiąc | Najtańszy plan | Twoje koszty | Za 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 |
Punkty przełączania: Starter jest korzystniejszy niż Indie od 16 PDF, Pro od Starter od 57, Reports Pack od Pro od 187, jeśli nie potrzebujesz niczego poza raportami, Business od Reports Pack od 367. Pro i Business otwierają również resztę API, Pack tylko raporty i white-label.
Zysk marży ustawiasz Ty. Przy 300 PDF w Reports Pack Twoje koszty wynoszą $99 na miesiąc. Po $9 za sztukę to $2700 przychodu przeciwko $99 kosztów, po $19 to $5700. Cenę detaliczną nie polecamy, ale arytmetyka jest taka sama dla każdej: Twoja cena minus 33 centów.
Rozszerzony raport urodzinowy kosztuje dwukrotnie więcej niż standardowy, więc na każdym planie wyżej jest podwójna cena za PDF: $0.66 w Reports Pack.
Dwie rzeczy obniżają rzeczywiste koszty jeszcze bardziej. Powtórzone żądanie z tymi samymi danymi zwraca ten sam plik z cache odpowiedzi i nic nie kosztuje, więc klient, który załadował raport dwukrotnie, jest opłacany raz. A roczny plan to 12 miesięcy za ceną 9, a Reports Pack kosztuje $0.25 za PDF.
Przed sprzedażą otwórz przykłady: każdy to ten sam plik, który zwraca API, a z whitelabel Twoja nazwa i kolory zastępują typowe.
Jeśli potrzebny jest tekst, a nie dokument
Dział zatytułowany „Jeśli potrzebny jest tekst, a nie dokument”Pięć endpointów zwraca AI-narrację jako JSON, bez składania i bez PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Po 250 kredytów. Weź je, gdy tekst idzie do Twojego własnego szablonu, aplikacji lub newslettera.
Raport urodzinowy potrafi również tryb mieszany: enrich: true dodaje AI-narrację wewnątrz PDF. Na tej samej testowej mapie to 5 stron zamiast 3.