Reports API - 16 kész PDF-riport a saját márkáddal

Elküldöd a születési dátumot, és kész dokumentumot kapsz vissza. Nem JSON-t, amiből még PDF-et kell tördelni, hanem magát a PDF-et: oldalanként megtördelve, a te logóddal, a te riportcímeddel, és rólunk egyetlen említés nélkül.

Tizenhat ilyen riport működik már. A diszpécserrel, az exportelőzményekkel és az öt AI-narratívával együtt ez 23 útvonal a /v1/reports/* alatt.

Katalógus

Minden sorhoz tartozik kész minta. Ez nem makett: a fájlt ugyanaz a hívás generálta, amely az adott végpont referenciájában szerepel, és a sablonokkal együtt újragenerálódik.

Az oldalszám az, amit épp ez a minta adott, 2026-09-21-én mérve. Képletenként ingadozik: több fényszög több sort jelent, a relocation pedig városonként két-három oldalt tesz hozzá (egy városnál 4 oldal, ötnél 13).

Végpont	Mi van benne	Oldal	Kredit	Minta
/v1/reports/natal	Nagy hármas, bolygók, házak, fényszögek	3	5 000	PDF
/v1/reports/synastry	Két képlet közötti fényszögek, elemegyensúly	2	5 000	PDF
/v1/reports/transit-yearly	Tranzit-előrejelzés a választott évre	5	5 000	PDF
/v1/reports/relocation	Kiinduló képlet, legfeljebb 5 város, házat váltó bolygók, közeli vonalak, 19 életterület	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna és nakshatra, sziderikus pozíciók, Vimshottari mahadashák	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, feltárt rinák, upayák	2	5 000	PDF
/v1/reports/gemstone	Kőajánlás mantrákkal, kerülendő kövek, a grahák állapota	7	5 000	PDF
/v1/reports/human-design	Fő paraméterek, centrumok, csatornák	2	5 000	PDF
/v1/reports/muhurta	Rangsorolt kedvező napok egy tevékenységhez	4	5 000	PDF
/v1/reports/love	A szerelem kulcspontjai, nagy hármas, fényszögek	2	5 000	PDF
/v1/reports/career	A karrier kulcspontjai, személyiségkontextus, fényszögek	2	5 000	PDF
/v1/reports/money	Pénzügyi kulcspontok, házak, fényszögek	3	5 000	PDF
/v1/reports/business	Üzleti kulcspontok, házak, fényszögek	2	5 000	PDF
/v1/reports/child	Fő jellemvonások, nagy hármas, bolygók	2	5 000	PDF
/v1/reports/stellaforge	Egyoldalas képletposzter: bolygók, egyensúly, fő fényszögek	1	5 000	PDF
/v1/reports/tarot	A kirakás és a lapok leírása	2	100	PDF

A tarot ötvenszer olcsóbb, mert nincsenek benne efemeriszek: egy oldalnyi kirakás csillagászati számítások nélkül.

Egy útvonal tizenhat helyett

A POST /v1/reports/generate egy report_type mezőt fogad, és ugyanazt csinálja, mint a külön útvonal. Tizenkét típus: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Az SDK-ban ez egy metódus tizenkettő helyett, az MCP-ben egy eszköz tizenkettő helyett. Az ár ugyanaz: a diszpécseren át indított hívás pontosan annyit von le, mint a közvetlen útvonal.

PDF vagy HTML

Alapértelmezés szerint PDF érkezik, és egy link hozzá. A ?format=html a kész HTML-oldalt közvetlenül a válaszban adja vissza, renderelés és tárolás nélkül: kényelmes, ha a riportot a saját oldaladba ágyazod, vagy saját CSS-t szeretnél alá tenni.

A PDF-link 24 óráig él. Ez szándékos: mások dokumentumait nem tároljuk korlátlan ideig. Töltsd le magadhoz a fájlt közvetlenül a válasz után. A GET /v1/reports/history ingyen mutatja az adott kulcs legutóbbi exportjait, a lejárt bejegyzés pedig expired: true értékkel érkezik.

A te márkád, nem a miénk

A whitelabel egy 15 mezős objektumot fogad: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing és öt szín (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

Közvetlenül a kérésben is átadhatod, ilyenkor semmilyen fiókbeállításra nincs szükség:

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

A generált dokumentumban a stúdió neve, a saját riportcím, a szakaszcímek kiemelőszíne és a te láblécet szerepel. Az AstroWay szó egyszer sem fordul elő benne.

Alternatíva azoknak, akik nem akarják minden kérésben megismételni az objektumot: a whitelabel: true a fiók elmentett konfigurációját használja (/v1/whitelabel/config), a POST /v1/whitelabel/preview pedig ezzel rajzol egy minta születési riportot, hogy megnézhesd, mielőtt az ügyfélnek megmutatod.

Klónozható kész alkalmazás

Élő demó és kód a GitHubon, MIT.

Egy gyakorló asztrológus asztala: balra az ügyfél adatai, jobbra a kész PDF. Minden riportcsempe kattintás előtt mutatja az árat kreditben, és a kész mintára visz. A white-label egy jelölőnégyzettel kapcsolható be. A backend egyetlen útvonal függőségek nélkül, mert épp ez a lényeg: a böngésző nem szólhat közvetlenül az API-hoz, ezért a kulcs a szerveren él.

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

Négy dolgot érdemes átvenni. Az ár ott látszik, ahol a döntés születik: a szerver az X-Credits-Used értéket visszaküldi az oldalnak, nem csak a naplóba. Tizenhat riportnak négy kérésformája van, nem tizenhat. Ugyanaz a kérés másodszorra nulla kreditbe kerül, mert a válasz-gyorsítótár ugyanazt a fájlt adja vissza. Az ALLOWED_REPORTS pedig korlátozza, mit hajlandó renderelni a példány: a nyilvános demó csak tarot-kirakást renderel (/v1/reports/tarot, 100 kredit), mert a nyílt interneten álló oldal, amely bárkinek születési riportot készít (/v1/reports/natal, 5 000), két kattintással elégeti a havi ingyenes keretet.

Nyelvek

A language mező 21 kódot fogad. Teljesen lefordítva három van: ukrán, angol, orosz. A többi tizennyolcnál a jegyek neve lokalizált, a címek és a magyarázatok viszont angolul maradnak: egy német riport “Löwe”-t ír a “Planets” cím alá.

Ezt egyenesen kimondjuk, mert a riport olyan dokumentum, amelyet az ügyfeled megtart. Ha németként adnád el, mert a példában német jegyneveket láttál, az kellemetlen meglepetés lenne az ügyfél oldalán, nem a miénken. A muhurta riport egyelőre teljesen angol.

Figyelem

Mérve 2026-09-20-án. Ha egy adott nyelvre teljes egészében szükséged van, írj nekünk: a kézi fordítások sora a kereslet szerint halad, nem lista szerint.

Hány riport jön ki egy csomagból

A /v1/reports/natal és a többi PDF 5 000 kreditbe kerül, így a csomag havi kerete egyszerűen átszámolható riportok számára:

Csomag	Kredit/hó	PDF-riport	Tarot-riport
Free	10 000	riportok nem érhetők el	nem érhetők el
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

A Free csomagban a riportok szándékosan zárva vannak: egy PDF másodpercnyi Chrome-munka a mi oldalunkon, és az ingyenes csomag ezt nem fedezi. A legolcsóbb belépő az Indie, $5-ért.

A Reports Pack külön kiegészítő azoknak, akiknek csak riportok kellenek: havi $99, 500 000 kredit, vagyis 100 PDF darabonként 99 centért, white-label-lel. Az ilyen csomagú kulcs csak a /v1/reports/* és a /v1/whitelabel/* útvonalakat éri el.

Ha szöveg kell, nem dokumentum

Öt végpont JSON-ként adja vissza az AI-narratívát, tördelés és PDF nélkül: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Darabonként 250 kredit. Ezeket válaszd, ha a szöveg a saját layoutodba, alkalmazásodba vagy hírleveledbe kerül.

A születési riport vegyes módot is ismer: az enrich: true AI-narratívát tesz a PDF-be. Ugyanazon a tesztképleten ez 3 helyett 5 oldal.