Reports API - 16 hotových PDF reportů pod tvou značkou

Pošleš datum narození a dostaneš hotový dokument. Ne JSON, ze kterého je potřeba vysázet PDF, ale samotné PDF: vysázené po stránkách, s tvým logem, tvým názvem reportu a bez jediné zmínky o nás uvnitř.

Šestnáct takových reportů už funguje. Spolu s dispečerem, historií exportů a pěti AI narativy je to 23 cest pod /v1/reports/*.

Katalog

Každý řádek má hotový vzorek. Není to maketa: soubor byl vygenerován stejným voláním, jaké je vytištěné v referenci daného endpointu, a vydává se znovu spolu se šablonami.

Počet stránek je ten, který dal právě tento vzorek, změřený 2026-09-21. Liší se podle horoskopu: víc aspektů znamená víc řádků a relocation přidává dvě až tři stránky za každé město (4 stránky pro jedno město, 13 pro pět).

Endpoint	Co je uvnitř	Stránek	Kreditů	Vzorek
/v1/reports/natal	Velká trojka, planety, domy, aspekty	3	5 000	PDF
/v1/reports/synastry	Aspekty mezi dvěma horoskopy, rovnováha živlů	2	5 000	PDF
/v1/reports/transit-yearly	Předpověď tranzitů na zvolený rok	5	5 000	PDF
/v1/reports/relocation	Výchozí horoskop, až 5 měst, planety, které změnily dům, blízké linie, 19 životních oblastí	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna a nakšatra, siderické pozice, mahádaše Vimšottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, zjištěné riny, upáje	2	5 000	PDF
/v1/reports/gemstone	Doporučení kamenů s mantrami, kameny, které nenosit, stav grah	7	5 000	PDF
/v1/reports/human-design	Klíčové parametry, centra, kanály	2	5 000	PDF
/v1/reports/muhurta	Seřazené příznivé dny pro jednu činnost	4	5 000	PDF
/v1/reports/love	Klíčové body lásky, velká trojka, aspekty	2	5 000	PDF
/v1/reports/career	Klíčové body kariéry, kontext osobnosti, aspekty	2	5 000	PDF
/v1/reports/money	Klíčové finanční body, domy, aspekty	3	5 000	PDF
/v1/reports/business	Klíčové body podnikání, domy, aspekty	2	5 000	PDF
/v1/reports/child	Klíčové povahové rysy, velká trojka, planety	2	5 000	PDF
/v1/reports/stellaforge	Plakát horoskopu na jednu stránku: planety, rovnováha, klíčové aspekty	1	5 000	PDF
/v1/reports/tarot	Popis výkladu a karty	2	100	PDF

Tarot stojí padesátkrát méně, protože v něm nejsou efemeridy: jedna stránka výkladu bez astronomických výpočtů.

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 jedna metoda místo dvanácti, pro MCP jeden nástroj místo dvanácti. Cena je stejná: volání přes dispečer odečte přesně tolik jako přímá cesta.

PDF nebo HTML

Ve výchozím stavu přijde PDF a odkaz na něj. ?format=html vrátí hotovou HTML stránku přímo v odpovědi, bez renderování a bez ukládání: hodí se, když report vkládáš do své stránky nebo chceš použít vlastní CSS.

Odkaz na PDF platí 24 hodin. Je to záměr: cizí dokumenty nehostujeme natrvalo. Stáhni si soubor k sobě hned po odpovědi. GET /v1/reports/history zdarma ukazuje poslední exporty tohoto klíče a záznam po expiraci přijde s expired: true.

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 pak 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" } }'

Ve vygenerovaném dokumentu je název studia, vlastní nadpis reportu, akcentní barva v nadpisech sekcí a tvoje patička. Slovo AstroWay v něm není ani jednou.

Alternativa pro ty, kdo nechtějí objekt opakovat v každém požadavku: whitelabel: true vezme uloženou konfiguraci účtu (/v1/whitelabel/config) a POST /v1/whitelabel/preview s ní vykreslí vzorek natálního reportu, aby ses mohl podívat dřív, než ho ukážeš klientovi.

Hotová aplikace, kterou můžeš naklonovat

Živé demo a kód na GitHubu, MIT.

Pracovní stůl praktika: údaje 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škrtávacím políčkem. Backend je jedna cesta bez závislostí, protože právě v tom je pointa: prohlížeč nemůže volat API přímo, takže klíč žije na serveru.

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

Čtyři věci, které si z ní stojí za to vzít. Cena je ukázaná tam, kde se rozhoduje: server vrací X-Credits-Used zpět na stránku, ne jen do logu. Šestnáct reportů má čtyři tvary požadavku, ne šestnáct. Tentýž požadavek podruhé stojí nula, protože cache odpovědí vrátí tentýž soubor. A ALLOWED_REPORTS omezuje, co přesně instance souhlasí vyrenderovat: veřejné demo renderuje jen tarotový výklad (/v1/reports/tarot, 100 kreditů), protože stránka na otevřeném internetu, která komukoli vyrobí natální report (/v1/reports/natal, 5 000), spálí měsíční bezplatný limit za dvě kliknutí.

Jazyky

Pole language přijímá 21 kódů. Úplně přeložené jsou tři: ukrajinština, angličtina, ruština. Pro zbylých osmnáct se lokalizují názvy znamení, zatímco nadpisy a vysvětlení zůstávají anglicky: 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ává. Prodat ho jako německý jen proto, že v ukázce byly německé názvy znamení, by bylo nepříjemné odhalení na straně klienta, ne na naší. Report muhurta je zatím celý anglicky.

Upozornění

Změřeno 2026-09-20. Pokud potřebuješ konkrétní jazyk celý, napiš nám: fronta ručních překladů se řídí poptávkou, ne seznamem.

Kolik reportů vychází na plán

/v1/reports/natal a ostatní PDF stojí 5 000 kreditů, takže měsíční limit plánu se na počet reportů převede jednoduše:

Plán	Kreditů/měs	PDF reportů	Tarotových reportů
Free	10 000	reporty nedostupné	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	500 000	100	5 000

Na Free jsou reporty uzavřené záměrně: jedno PDF znamená sekundy práce Chrome na naší straně a bezplatný tarif je nepokryje. Nejlevnější vstup je Indie za $5.

Reports Pack je samostatný doplněk pro ty, kdo potřebují jen reporty: $99 měsíčně, 500 000 kreditů, tedy 100 PDF po 99 centech za kus, s white-label. Klíč takového plánu chodí jen do /v1/reports/* a /v1/whitelabel/*.

Když potřebuješ text, ne dokument

Pět endpointů vrací AI narativ jako JSON, bez sazby a bez PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Po 250 kreditech. Použij je, když text jde do tvého vlastního layoutu, aplikace nebo newsletteru.

Natální report umí i smíšený režim: enrich: true přidá AI narativ dovnitř PDF. Na stejném testovacím horoskopu je to 5 stránek místo 3.