Reports API - 16 kész PDF-riport a saját márkáddal
Adszólálsz egy születési dátumot, és kapod egy kész PDF-dokumentumot. Nem JSON-t, amit PDF-be kell tervezned, hanem egy teljesen kész PDF-t: oldalaszerkesztéssel, a saját logóddal, a jelentésed címével, és egyáltalán nincs benne semmi utalás ránk.
Még tizenhat ilyen jelentés működik. Egy adminisztrátorral, exportelőkészítési történetével és öt AI-narratívával együtt ez 23 út /v1/reports/* alatt.
Katalógus
Szekció neve “Katalógus”Mindig egy példa van minden sorban. Ez nem egy vázlat: a fájl generálva ugyanazokkal az adatokkal, mint amiket a dokumentációban látható, és újra generálódik a szablonokkal együtt.
Az oldalszám az, amit ez a példa adott meg, mért 2026. szeptember 21-én. Ez változik a térképtől: több aspektus több sort jelent, és a relocation hozzáad 2-3 oldalt minden városhoz (4 oldal egy városra, 13 öt városra).
| Endpoint | Mit tartalmaz | Oldalak | Kreditek | Peldány |
|---|---|---|---|---|
/v1/reports/natal | Nagy hármas, bolygók, házak, aspektusok | 3 | 5 000 | |
/v1/reports/synastry | Két térkép közötti aspektusok, elemek egyensúlya | 2 | 5 000 | |
/v1/reports/transit-yearly | Éves tranzit-jövőelőrejelzés | 5 | 5 000 | |
/v1/reports/relocation | Kezdeti térkép, max. 5 város, bolygók, amelyek megváltoztatták házukat, szomszédos vonalak, 19 életkör | 6 | 5 000 | |
/v1/reports/vedic-kundli | Lagna és nakshatra, sziderikus pozíciók, mahadashi és vimshottari | 2 | 5 000 | |
/v1/reports/lal-kitab | Kismat, teva, felfedezett rini, upayi | 2 | 5 000 | |
/v1/reports/gemstone | Kőjavaslatok mantrákkal, melyik köveket ne viseljen, graha állapot | 7 | 5 000 | |
/v1/reports/human-design | Kulcsfontosságú paraméterek, centerek, csatornák | 2 | 5 000 | |
/v1/reports/muhurta | Rangsorolt kedvező napok egy tevékenységre | 4 | 5 000 | |
/v1/reports/love | Kulcsfontosságú szerelmes pontok, nagy hármas, aspektusok | 2 | 5 000 | |
/v1/reports/career | Kulcsfontosságú karrier pontok, személyiség kontextusa, aspektusok | 2 | 5 000 | |
/v1/reports/money | Kulcsfontosságú pénzügyi pontok, házak, aspektusok | 3 | 5 000 | |
/v1/reports/business | Kulcsfontosságú üzleti pontok, házak, aspektusok | 2 | 5 000 | |
/v1/reports/child | Gyerek karakterjegyek, nagy hármas, bolygók | 2 | 5 000 | |
/v1/reports/stellaforge | Egy oldalas térkép poszter: bolygók, egyensúly, kulcsaspektusok | 1 | 5 000 | |
/v1/reports/tarot | A tervezés leírása és a lapok | 2 | 100 | |
/v1/reports/vastu | Háztérrajz mandalával, értékelés, Vasztu-találmányok forrásokkal és javításokkal | 2 | 5 000 |
A Tarot 50-szor olcsóbb, mert nincs efemeridákkal: egy lap tervezés egy oldalon, nincsenek csillagászati számítások.
Mélység: standard vagy extended
Szekció neve “Mélység: standard vagy extended”A /v1/reports/natal (és /v1/reports/generate a report_type: "natal"-val) fogadja a depth mezőt. A standard egy 5000 kredit értékű dokumentum. Az extended 10000 kreditet kerül, és hozzáadja a térkép kerekét és egy szakaszt minden testről a Naptól a Plutónig, a Kironig és az Aszcendentig a jelben: tizenkét szakasz, mindegyik 2-4 oldalnyi szerkesztett szöveggel (PDF példa, 13 oldal), ugyanazt a tartalmat, amit /v1/natal-texts ad vissza. Semmi nem generálódik a kérésre, így ugyanaz a térkép ugyanazt a dokumentumot adja vissza.
A szakaszok 20 nyelven vannak, a weboldal nyelveivel. A depth: "extended" más nyelven nem működik, hanem 400 hibát ad vissza, nem töltődik be egy másik nyelvből. A többi jelentés típusnak még csak egy mélysége van: hosszú szakaszok még nem írták meg.
Egy út helyett tizenhat
Szekció neve “Egy út helyett tizenhat”A POST /v1/reports/generate fogadja a report_type mezőt és ugyanazt teszi, mint egy külön út. Tizenkét típus: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.
Ez az SDK számára egy metódus helyett tizenkét, az MCP számára egy eszköz helyett tizenkét. Az ár ugyanaz: a kérés az adminisztrátoron keresztül levon egy olyan mennyiséget, amennyit a közvetlen út is.
PDF, HTML vagy Markdown
Szekció neve “PDF, HTML vagy Markdown”Minden jelentés típus, és az adminisztrátor is, fogadja a format mezőt: a kérés testében vagy ?format= paraméterként a kérés sorában (egy alkalommal küldd; két különböző érték ad 400 hibát). Az ár azonos a háromban, mert a dokumentumért fizetsz, nem a fájlért, amelyben érkezik.
format | Mi visszatér | Mentve |
|---|---|---|
pdf (default) | JSON a url PDF-vel, page_count-el és expires_at-tal | 24 óra vagy retain_days |
html | A dokumentum maga, Content-Type: text/html | nem mentve |
markdown | Az ugyanaz a dokumentum Markdown-ban, Content-Type: text/markdown | nem mentve |
HTML egy teljes, önálló fájl: a stílusok benne vannak, a térkép kereke és a Vasztu térrajz beépített SVG-ként, nincsenek skriptek és nincs külső betűtípus. Ez ugyanaz a oldal, amelyről a PDF nyomtatásos, ugyanazzal a white-label blokkal: a cég neve, a jelentés címe, a színek és a lábjegyzet. Az egyetlen külső link a logoUrl-od, ami egy HTTPS-képre mutat, ugyanúgy, mint a PDF-ben. Minden név, hely és szöveg, amit elküldsz, elkerülődik, így egy név, mint <img onerror=...> nyomtatáskor szöveggé alakul. A dokumentumot be lehet ágyazni a saját oldaladba vagy egy iframe-be.
Markdown ugyanazok a fejezetek, szövegek és táblázatok. A fejezetek szintje megőrzött: # a jelentés címe, ## a szakasz, ### a részcikk, ugyanaz a sorrend, mint a PDF-ben, így a ## -vel kezdődő sorok felosztása szakaszokra. A táblázatok GitHub formátumúak. A kép (kerek, térkép) hiányzik, helyette egy sor megjegyzés. Minden karakter, amit a Markdown vagy az HTML-renderelő a szövegben HTML-ként olvasna, elkerülődik egy visszalépő köszönettel.
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" }'A PDF-re mutató link 24 órán érvényes. Ahhoz, hogy a klientnek hosszabb idejű linket adj, adj hozzá ?retain_days=30 (max. 90): a fájl ennyi napig lesz elérhető, és az expires_at a válaszban ezt mutatja. Teljes mértékben nem tárolunk idegen dokumentumokat, és a fájlt korábban is törölheted a DELETE /v1/reports/files/{filename}-vel, ingyenesen. A fájl tartalmazza, amit elküldtél, együtt a névvel, így a tárolási időt a DPA 2. szakaszában írják le. A GET /v1/reports/history ingyenesen mutatja az utolsó exportokat ebben a kulcsban, és a lejárat időtartama expired: true-val érkezik.
A saját márkád, nem az enyém
Szekció neve “A saját márkád, nem az enyém”A whitelabel fogad egy 15 mezős objektumot: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing és öt szín (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).
Ezt közvetlenül a kérésben is küldheted, és ekkor nem szükséges semmilyen beállítás a kontoidban:
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 jelentés címe, a fejezetekben kiemelt szín és a saját lábjegyzet. Az AstroWay szó egyáltalán nem szerepel benne.
Egy alternatíva azoknak, akik nem akarnak minden kérésben újra megadni az objektumot: whitelabel: true használja a mentett konfigurációt. Beállítsd a Jelentés-brandelődés oldalon a kontoidban: a cég neve, a jelentés neve, a kontaktusok, a logo és két szín, egy példa a születési jelentésre. Ezek az beállítások elérhetők kulccsal a /v1/whitelabel/config és /v1/whitelabel/logo útvonalakon, és a POST /v1/whitelabel/preview PDF példát rajzol. Az objektumban átadott mező felülírja a mentettet.
Kész alkalmazás, ami klónozható
Szekció neve “Kész alkalmazás, ami klónozható”Élő demo és kód a GitHub-on, MIT.
A gyakorló asztal: a klient adatai balra, a kész PDF jobbra. Minden jelentés lapka mutatja a kreditek számát a klikk előtt és vezet a kész példára. A white-label bekapcsolható egy jelölővel. A háttér a egy útvonal nélkül függőségektől, mert ez az egész lényeg: a böngésző nem tud közvetlenül az API-hez fordulni, így a kulcs a szerveren él.
git clone https://github.com/astroway/starter-practicecd starter-practice && npm installcp .env.example .env # your key goes herenpm run devNégy dolog, amit el kell venni. Az ár a döntés helyén látható: a szerver visszaadja az X-Credits-Used-t a oldalra, nem csak a logba. Tizenhat jelentésnek négy kérésformája van, nem tizenhat. Az ugyanaz a kérés újra 0-t kerül, mert a válaszok cache-olása ugyanazt a fájlt adja vissza. És az ALLOWED_REPORTS korlátozza, hogy mi fog rájönni a rögzítésre: a nyilvános demo csak a Tarot-tervezést (/v1/reports/tarot, 100 kredit) rögzíti, mert a nyilvános oldal, amelyik egy születési jelentést (/v1/reports/natal, 5 000) készít bárkinek, két klikkel kiüríti a havi ingyenes limitet.
Nyelvek
Szekció neve “Nyelvek”A language mező 21 kódot fogad. Teljes mértékben fordított három: ukrán, angol, orosz. A többi tizenhétben csak a jelnek a nevei fordítva vannak, a fejezetek és magyarázatok angolok maradnak: egy német jelentés írja “Löwe”-t a “Planets” fejezet alatt.
Ezért írjuk így, mert a jelentés egy dokumentum, amit a klient magának hagy. Eladni azt németnek, látva a német jelneveket a példában, egy kellemetlen felfedezés lenne a klient oldalon, nem a miénk. A muhurta jelentés még mindig teljes egészében angol.
Hány jelentés kerül ki egy tervezésből
Szekció neve “Hány jelentés kerül ki egy tervezésből”A /v1/reports/natal és a többi PDF 5000 kreditet kerül, így a havi limit egy tervezésben egyszerűen átváltásba kerül:
| Tervezés | Kreditek/év | PDF-jelentések | Tarot-jelentések |
|---|---|---|---|
| Free | 10 000 | jelentések nem elérhetők | nem elérhetők |
| 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 |
A Free-n a jelentések szándékosan zárva vannak: minden PDF másodpercnyi rögzítésünk, és a free tervezés nem fedi ezt. A legolcsóbb bejutás az Indie $5-ös tervezés.
Reports Pack egy külön tervezés azoknak, akik csak jelentésekre van szükségük: $99 havi, 1 500 000 kredit, vagyis 300 PDF 33 centért egy darabon, white-label-lel. Ez olcsóbb a PDF-nél a Pro-nál, mert a kulcs csak a jelentésekhez jár, nem máshová. Egy ilyen tervezésű kulcs csak a /v1/reports/* és /v1/whitelabel/* útvonalakon jár.
A jelentések árusítása: mennyibe kerül egy PDF
Szekció neve “A jelentések árusítása: mennyibe kerül egy PDF”Ha eladod a jelentéseket a klienteidnek, egy számra van szükség: mennyibe kerül egy PDF a te forgalmadban. A tervezés limitje belül ez a tervezés ára, osztva a PDF számával. A limit felett minden PDF átlagos áron kerül, ami a tervezés átlagos ára 10 000 kredit felett, így egy 5000 kredit értékű PDF a tervezés átlagos ára felét kerül.
| Tervezés | PDF a tervezésben | Ár a tervezésben | Minden PDF a limit felett |
|---|---|---|---|
| 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 |
Így a legolcsóbb tervezés attól függ, hogy mennyi PDF-t adsz el havonta, átlagos áron:
| PDF/év | Legolcsóbb tervezés | Tehát a kiadásod | Egy PDFért |
|---|---|---|---|
| 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 |
Átmeneti pontok: a Starter az Indie-nél előnyösebb 16 PDF-nél, a Pro a Starter-nél 57-nél, a Reports Pack a Pro-nál 187-nél, ha csak jelentésekre van szükséged, a Business a Reports Pack-nál 367-nél. A Pro és Business nyitja meg a többi API-t, a Pack csak jelentéseket és white-label-et.
A nyereségedet te állítod be. 300 PDF-nél a Reports Pack-nál havi kiadásod $99. $9 egy darabon $2700 bevétel, $99 kiadás ellenében, vagy $19 egy darabon $5700. A vételi árat nem ajánljuk, de a matematikai elv ugyanaz: a te árad - 33 cent.
A kiterjesztett születési jelentés kétszeres ára a standardhoz képest, így minden tervezésnél ez a kétszeres PDF-ár: $0.66 a Reports Pack-nál.
Két dolog csökkenti a valós kiadásokat még. Egy ismételt kérés ugyanazokkal az adatokkal ugyanazt a fájlt adja vissza a válasz cache-jéből és semmit nem kerül, így egy klient, aki a jelentést kétszer töltötte le, egyszer fizet. És az éves tervezés 12 hónap 9%-os áron, így a Reports Pack $0.25-re kerül egy PDF-nél.
Eladást kezdve, nyisd meg a példákat: minden egy olyan fájl, amit az API visszaad, és a whitelabel-lel a saját név és színeid kerülnek a helyükre a szabványos helyett.
Ha szövegre van szükség, nem dokumentumra
Szekció neve “Ha szövegre van szükség, nem dokumentumra”Öt endpoint ad vissza AI-narratívát JSON-ban, nincsenek formázások és nincs PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Mindegyik 250 kreditet kerül. Vedd őket, ha a szöveg a saját formázásodba, alkalmazásodba vagy newsletteredbe kerül.
A születési jelentés képes kevert módra is: enrich: true hozzáadja az AI-narratívát a PDF-be. Ugyanaz a teszt térkép 5 oldal helyett 3-nál.