Reports API - 16 hotových PDF reportů pod tvou značkou
Odesíláš datum narození a získáš hotový dokument. Ne JSON, ze kterého bys musel skládat PDF, ale samotné PDF: stránku po stránce sestavené, s tvým logem, tvým názvem reportu a bez jediného zmínky o nás uvnitř.
Šestnáct takových reportů již běží. Spolu s dispečerem, historií exportů a pěti AI narativy je to 23 cest pod /v1/reports/*.
Katalog
Sekce “Katalog”Každý řádek má hotový vzorek. Není to mockup: soubor byl vygenerován stejným voláním, které je uvedeno v dokumentaci tohoto endpointu, a je znovu vydáván společně s šablony.
Počet stránek odpovídá tomu, co dal právě tento vzorek, měřeno k 2026-09-21. Počet kolísá podle karty: více aspektů znamená více řádků a relocation přidává dvě až tři stránky na každé město (4 stránky pro jedno město, 13 pro pět).
| Endpoint | Co je uvnitř | Stránky | Kreditů | Vzorek |
|---|---|---|---|---|
/v1/reports/natal | Velká trojice, planety, domy, aspekty | 3 | 5 000 | |
/v1/reports/synastry | Mezikartové aspekty dvou karet, rovnováha prvků | 2 | 5 000 | |
/v1/reports/transit-yearly | Předpověď tranzitů pro vybraný rok | 5 | 5 000 | |
/v1/reports/relocation | Nataální karta, až 5 měst, planety, které změnily dům, linie v blízkosti, 19 oblastí života | 6 | 5 000 | |
/v1/reports/vedic-kundli | Lagna a nakshatra, siderické pozice, mahadashi Vimshottari | 2 | 5 000 | |
/v1/reports/lal-kitab | Kismat, deva, zjištěné rini, upayee | 2 | 5 000 | |
/v1/reports/gemstone | Doporučení kamenů s mantrami, jaké kameny nenosit, stav grah | 7 | 5 000 | |
/v1/reports/human-design | Klíčové parametry, centra, kanály | 2 | 5 000 | |
/v1/reports/muhurta | Seřazené příznivé dny pro jednu aktivitu | 4 | 5 000 | |
/v1/reports/love | Klíčové body lásky, velká trojice, aspekty | 2 | 5 000 | |
/v1/reports/career | Klíčové body kariéry, kontext osobnosti, aspekty | 2 | 5 000 | |
/v1/reports/money | Klíčové finanční body, domy, aspekty | 3 | 5 000 | |
/v1/reports/business | Klíčové body byznysu, domy, aspekty | 2 | 5 000 | |
/v1/reports/child | Klíčové rysy povahy, velká trojice, planety | 2 | 5 000 | |
/v1/reports/stellaforge | Poster karty na jednu stránku: planety, rovnováha, klíčové aspekty | 1 | 5 000 | |
/v1/reports/tarot | Popis rozkladu a karet | 2 | 100 | |
/v1/reports/vastu | Plán domu s mandalou, hodnocení, nálezy Vastu se zdroji a opravami | 2 | 5 000 |
Tarot stojí padesátkrát méně, protože tam nejsou efemeridy: jedna stránka rozkladu bez astronomických výpočtů.
Hloubka: standard nebo extended
Sekce “Hloubka: standard nebo extended”/v1/reports/natal (a /v1/reports/generate s report_type: "natal") přijímá depth. standard je výše uvedený dokument, 5000 kreditů. extended stojí 10000 kreditů a přidává kolo karty a sekci pro každé těleso od Slunce po Plutona, Chiron a Ascendent v znamení: dvanáct sekcí, každá o dvou až čtyřech stránkách editovaného textu (vzorek PDF, 13 stránek) ze stejného korpusu, který poskytuje /v1/natal-texts. Nic se negeneruje na požadavék, takže stejná karta poskytne stejný dokument.
Sekce jsou ve 20 jazycích, jazycích webu; depth: "extended" s jiným jazykem vrátí chybu 400, místo aby se vyplnil v jiném jazyce. Ostatní typy reportů mají zatím pouze jednu hloubku: jejich dlouhé sekce ještě nejsou napsány.
Jedna cesta místo šestnácti
Sekce “Jedna cesta místo šestnácti”POST /v1/reports/generate přijímá pole report_type a dělá totéž co samostatná cesta. Dvanáct typů: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.
Pro SDK je to jeden metod místo dvanácti, pro MCP jeden nástroj místo dvanácti. Cena je stejná: volání přes dispečera stáhne přesně tolik, jako přímá cesta.
PDF, HTML nebo Markdown
Sekce “PDF, HTML nebo Markdown”Každý typ reportu, i dispečer, přijímá format: v těle požadavku nebo jako ?format= v query stringu (předej to pouze jednou; dvě různé hodnoty způsobí 400). Cena je ve všech třech stejná, protože platíš za dokument, nikoliv za soubor, ve kterém přichází.
format | Co se vrací | Ukládá se |
|---|---|---|
pdf (výchozí) | JSON s url PDF, page_count a expires_at | 24 hodin nebo retain_days |
html | Samotný dokument, Content-Type: text/html | neukládá se |
markdown | Stejný dokument ve formátu Markdown, Content-Type: text/markdown | neukládá se |
HTML je jeden samostatný soubor: styly jsou uvnitř, kolo karty a plán Vastu jako integrované SVG, bez skriptů a bez externích fontů. Je to ta samá stránka, ze které se tiskne PDF, se stejným white-label blokem: název společnosti, název reportu, barvy a patička. Jediný externí odkaz je tvé logoUrl, které zůstává odkazem na tvůj https-obrázek, stejně jako u PDF. Každé jméno, místo a text, které pošleš, je escapováno, takže jméno jako <img onerror=...> se vytiskne jako text. Dokument můžeš vložit do své stránky nebo do iframe.
Markdown má stejné nadpisy, text a tabulky. Úrovně nadpisů jsou zachovány: # je název reportu, ## sekce, ### podsekce, ve stejném pořadí jako v PDF, takže rozdělení podle řádků začínajících ## vytváří sekce. Tabulky jsou ve formátu GitHub. Obrázek (kolo, plán) chybí, na jeho místě je jeden řádek poznámky. Každý symbol, který by Markdown nebo renderér z HTML uvnitř přečetl jako značení, je escapován zpětným lomítkem.
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" }'Odkaz na PDF žije 24 hodin. Chceš-li klientovi poskytnout odkaz na delší dobu, přidej ?retain_days=30 (až do 90): soubor bude ležet tolik dní, což ukáže expires_at v odpovědi. Bez期限 nehostíme cizí dokumenty, ale soubor lze předčasně smazat pomocí DELETE /v1/reports/files/{filename}, zdarma. Soubor obsahuje to, co jsi poslal, spolu s názvem, proto je doba uchování popsána v DPA, sekce 2. GET /v1/reports/history zdarma zobrazuje poslední exporty tohoto klíče a vyprchaný záznam přichází s expired: true.
Tvoje značka, ne naše
Sekce “Tvoje značka, ne naše”whitelabel přijímá objekt s 15 poli: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing a pět barev (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).
Můžeš ho předat přímo v požadavku, a tehdy není potřeba žádné nastavení účtu:
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" } }'V vygenerovaném dokumentu bude název studia, vlastní nadpis reportu, akcentní barva v nadpisech sekcí a tvá patička. Slovo AstroWay se v něm nevyskytne ani jednou.
Alternativa pro ty, kteří nechtějí opakovat objekt v každém požadavku: whitelabel: true vezme uloženou konfiguraci účtu. Nastav si ji na stránce Branding reportů v panelu: název společnosti, název reportu, kontakty, logo a dvě barvy, s náhledem vzorku nataálního reportu. Stejná nastavení jsou dostupná s klíčem přes /v1/whitelabel/config a /v1/whitelabel/logo, a POST /v1/whitelabel/preview vykreslí vzorek v PDF. Pole předané v objektu má přednost před uloženým.
Hotová aplikace, kterou můžeš klonovat
Sekce “Hotová aplikace, kterou můžeš klonovat”Živé demo a kód na GitHub, MIT.
Praktické ukázkové prostředí: data klienta vlevo, hotové PDF vpravo. Každá dlaždice reportu ukazuje cenu v kreditech před kliknutím a vede na hotový vzorek. White-label se zapíná zaškrtnutím. Backend je jedna trasa bez závislostí, protože v tom je ta podstata: prohlížeč se nemůže přímo připojit k API, takže klíč žije na serveru.
git clone https://github.com/astroway/starter-practicecd starter-practice && npm installcp .env.example .env # your key goes herenpm run devČtyři věci, které si stojí vzít. Cena je zobrazena tam, kde se rozhoduje: server vrací X-Credits-Used zpět na stránku, nikoliv jen do logu. Šestnáct reportů má čtyři formáty požadavků, nikoliv šestnáct. Stejný požadavek podruhé stojí nulu, protože cache odpovědí vrací stejný soubor. A ALLOWED_REPORTS omezuje, co konkrétní instance souhlasí s vykreslením: veřejné demo vykresluje pouze tarotový rozklad (/v1/reports/tarot, 100 kreditů), protože stránka na volném internetu, která dělá nataální report (/v1/reports/natal, 5 000), by vyčerpala měsíční bezplatný limit dvěma kliknutími.
Jazyky
Sekce “Jazyky”Pole language přijímá 21 kódů. Úplně přeloženy jsou tři: ukrajinská, anglická, ruská. Pro zbývajících osmnáct jsou lokalizovány názvy znamení, ale nadpisy a vysvětlení zůstávají anglické: německý report napíše “Löwe” pod nadpisem “Planets”.
Píšeme to přímo, protože report je dokument, který si tvůj klient nechá. Prodat ho jako německý, když uvidí německé názvy znamení v ukázce, by bylo nepříjemným odhalením pro klienta, nikoliv pro nás. Report muhurta je zatím zcela anglický.
Kolik reportů vyjde v plánu
Sekce “Kolik reportů vyjde v plánu”/v1/reports/natal a ostatní PDF stojí 5 000 kreditů, takže měsíční limit plánu lze jednoduše převést na počet reportů:
| Plán | Kreditů/měs | PDF reportů | Tarot reportů |
|---|---|---|---|
| Free | 10 000 | reporty nejsou dostupné | nedostupné |
| 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 |
Ve Free jsou reporty záměrně zamknuty: každé PDF představuje sekundy renderování na naší straně a bezplatný tarif je nepokryje. Nejlevnější vstup je Indie za $5.
Reports Pack je samostatná aplikace pro ty, kteří potřebují pouze reporty: $99 měsíčně, 1 500 000 kreditů, což znamená 300 PDF po 33 centech za kus, s white-label. Je to levnější než PDF v Pro, protože klíč nikam nechodí kromě reportů. Klíč takového plánu funguje pouze v /v1/reports/* a /v1/whitelabel/*.
Resale reportů: kolik tě stojí PDF
Sekce “Resale reportů: kolik tě stojí PDF”Pokud prodáváš reporty svým klientům, důležitá je jedna číslice: kolik tě stojí jedno PDF při tvém objemu. V rámci limitu plánu je to cena plánu vydělená počtem PDF. Nad limitem jde každé PDF jako average, který se počítá za každých 10 000 kreditů nad limitem, takže PDF za 5000 kreditů stojí polovinu sazby average plánu.
| Plán | PDF v plánu | Cena PDF v rámci | Každé PDF nad |
|---|---|---|---|
| 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 |
Nejlevnější plán tedy závisí na tom, kolik PDF měsíčně prodáš, včetně average:
| PDF za měsíc | Nejlevnější plán | Tvé náklady | 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 |
Bodů přepnutí: Starter je výhodnější než Indie od 16 PDF, Pro než Starter od 57, Reports Pack než Pro od 187 (pokud nepotřebuješ nic jiného než reporty), Business než Reports Pack od 367. Pro a Business otevírají také zbytek API, Pack pouze reporty a white-label.
Marži si nastavíš ty. Při 300 PDF v Reports Pack jsou tvé náklady $99 měsíčně. Při $9 za kus je to $2700 příjmů proti $99 nákladům, při $19 je to $5700. Doporučujeme nepoužívat maloobchodní cenu, ale aritmetika je stejná: tvá cena mínus 33 centů.
Extended nataální report stojí dvakrát více než standardní, takže u každého vyššího plánu je to dvojnásobná cena za PDF: $0.66 v Reports Pack.
Dvě věci ještě sníží reálné náklady. Opakovaný požadavek se stejnými daty vrátí stejný soubor z cache odpovědí a nestojí nic, takže klient, který si report stáhl dvakrát, se platí pouze jednou. A roční plán je 12 měsíců za cenu 9, takže Reports Pack vychází na $0.25 za PDF.
Než začneš prodávat, prohlédni si vzorky: každý je přesně ten soubor, který vrací API, a s whitelabel se tvůj název a barvy stanou standardem.
Pokud potřebuješ text, nikoliv dokument
Sekce “Pokud potřebuješ text, nikoliv dokument”Pět endpointů vrací AI narativ jako JSON, bez formátování a bez PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Po 250 kreditů. Používej je, když text jde do tvého vlastního layoutu, aplikace nebo newsletteru.
Nataální report umí i smíšený režim: enrich: true přidá AI narativ přímo do PDF. Na té samé testovací kartě to znamená 5 stránek místo 3.