Reports API - 16 rapoarte PDF gata făcute sub brandul tău

Trimiți data nașterii, primești un document gata făcut. Nu un JSON din care trebuie să paginezi un PDF, ci PDF-ul însuși: paginat pagină cu pagină, cu logo-ul tău, cu numele raportului tău și fără nicio mențiune despre noi în interior.

Șaisprezece astfel de rapoarte funcționează deja. Împreună cu dispecerul, istoricul exporturilor și cele cinci narațiuni AI, sunt 23 de căi sub /v1/reports/*.

Catalog

Fiecare rând are un exemplu gata făcut. Nu este o machetă: fișierul este generat cu același apel care e tipărit în referința acestui endpoint și este regenerat odată cu șabloanele.

Numărul de pagini este cel dat de acest exemplu anume, măsurat pe 2026-09-21. Variază în funcție de hartă: mai multe aspecte înseamnă mai multe rânduri, iar relocation adaugă câte două-trei pagini pentru fiecare oraș (4 pagini pentru un oraș, 13 pentru cinci).

Endpoint	Ce conține	Pagini	Credite	Exemplu
/v1/reports/natal	Marea triadă, planete, case, aspecte	3	5 000	PDF
/v1/reports/synastry	Aspectele dintre cele două hărți, echilibrul elementelor	2	5 000	PDF
/v1/reports/transit-yearly	Prognoza tranzitelor pentru anul ales	5	5 000	PDF
/v1/reports/relocation	Harta de bază, până la 5 orașe, planetele care și-au schimbat casa, liniile din apropiere, 19 sfere ale vieții	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna și nakshatra, poziții siderale, mahadasha Vimshottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, rin identificate, upaye	2	5 000	PDF
/v1/reports/gemstone	Recomandarea pietrelor cu mantre, pietre care nu trebuie purtate, starea grahelor	7	5 000	PDF
/v1/reports/human-design	Parametri cheie, centre, canale	2	5 000	PDF
/v1/reports/muhurta	Zile favorabile clasate pentru o singură activitate	4	5 000	PDF
/v1/reports/love	Punctele cheie ale iubirii, marea triadă, aspecte	2	5 000	PDF
/v1/reports/career	Punctele cheie ale carierei, contextul personalității, aspecte	2	5 000	PDF
/v1/reports/money	Punctele financiare cheie, case, aspecte	3	5 000	PDF
/v1/reports/business	Punctele cheie ale afacerii, case, aspecte	2	5 000	PDF
/v1/reports/child	Trăsăturile cheie de caracter, marea triadă, planete	2	5 000	PDF
/v1/reports/stellaforge	Poster al hărții pe o singură pagină: planete, echilibru, aspecte cheie	1	5 000	PDF
/v1/reports/tarot	Descrierea tragerii și a cărților	2	100	PDF

Tarotul costă de cincizeci de ori mai puțin, pentru că nu are efemeride: o pagină de tragere fără calcule astronomice.

O singură cale în loc de șaisprezece

POST /v1/reports/generate acceptă câmpul report_type și face același lucru ca o cale separată. Douăsprezece tipuri: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Pentru SDK este o metodă în loc de douăsprezece, pentru MCP un instrument în loc de douăsprezece. Prețul e același: un apel prin dispecer consumă exact cât calea directă.

PDF sau HTML

Implicit vine un PDF și un link către el. ?format=html returnează o pagină HTML gata făcută direct în răspuns, fără randare și fără stocare: comod când încorporezi raportul în propria pagină sau vrei să pui propriul CSS.

Linkul către PDF trăiește 24 de ore. Este intenționat: nu găzduim documentele altora pe termen nelimitat. Descarcă fișierul la tine imediat după răspuns. GET /v1/reports/history arată gratuit ultimele exporturi ale acestei chei, iar o înregistrare expirată vine cu expired: true.

Brandul tău, nu al nostru

whitelabel acceptă un obiect cu 15 câmpuri: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing și cinci culori (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

Îl poți transmite direct în cerere, iar atunci nu e nevoie de nicio configurare a contului:

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

În documentul generat apar numele studioului, titlul propriu al raportului, culoarea de accent în titlurile secțiunilor și subsolul tău. Cuvântul AstroWay nu apare în el nici măcar o dată.

Alternativa pentru cei care nu vor să repete obiectul în fiecare cerere: whitelabel: true preia configurația salvată a contului (/v1/whitelabel/config), iar POST /v1/whitelabel/preview desenează un exemplu de raport natal cu ea, ca să vezi rezultatul înainte să-l arăți clientului.

O aplicație gata făcută pe care o poți clona

Demo live și codul pe GitHub, MIT.

Biroul practicianului: datele clientului în stânga, PDF-ul gata făcut în dreapta. Fiecare placă de raport arată prețul în credite înainte de clic și duce la un exemplu gata făcut. White-label se activează cu o bifă. Backend-ul este o singură rută fără dependențe, pentru că exact acolo e ideea: browserul nu poate apela API-ul direct, deci cheia stă pe server.

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

Patru lucruri care merită luate de aici. Prețul este afișat acolo unde se ia decizia: serverul trimite X-Credits-Used înapoi pe pagină, nu doar în log. Cele șaisprezece rapoarte au patru forme de cerere, nu șaisprezece. Aceeași cerere a doua oară costă zero, pentru că cache-ul răspunsurilor returnează același fișier. Iar ALLOWED_REPORTS limitează ce anume acceptă instanța să randeze: demo-ul public randează doar tragerea de Tarot (/v1/reports/tarot, 100 de credite), pentru că o pagină pe internetul deschis care face un raport natal (/v1/reports/natal, 5 000) pentru oricine consumă limita gratuită lunară din două clicuri.

Limbi

Câmpul language acceptă 21 de coduri. Complet traduse sunt trei: ucraineana, engleza, rusa. Pentru celelalte optsprezece sunt localizate numele semnelor, iar titlurile și explicațiile rămân în engleză: un raport german va scrie “Löwe” sub titlul “Planets”.

O spunem direct, pentru că raportul este un document pe care clientul tău îl păstrează. Să-l vinzi ca raport german după ce ai văzut nume germane de semne în exemplu ar fi o descoperire neplăcută de partea clientului, nu de a noastră. Raportul muhurta este deocamdată integral în engleză.

Atenție

Măsurat pe 2026-09-20. Dacă ai nevoie de o anumită limbă integral, scrie-ne: coada traducerilor manuale merge după cerere, nu după listă.

Câte rapoarte ies pe un plan

/v1/reports/natal și restul PDF-urilor costă 5 000 de credite, deci limita lunară a planului se convertește simplu în număr de rapoarte:

Plan	Credite/lună	Rapoarte PDF	Rapoarte Tarot
Free	10 000	rapoarte indisponibile	indisponibile
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

Pe Free rapoartele sunt închise intenționat: un PDF înseamnă secunde de lucru ale Chrome la noi, iar planul gratuit nu le acoperă. Cea mai ieftină intrare este Indie, la $5.

Reports Pack este un add-on separat pentru cei care au nevoie doar de rapoarte: $99 pe lună, 500 000 de credite, adică 100 de PDF-uri la 99 de cenți bucata, cu white-label. Cheia unui astfel de plan merge doar pe /v1/reports/* și /v1/whitelabel/*.

Dacă ai nevoie de text, nu de document

Cinci endpoint-uri returnează o narațiune AI ca JSON, fără paginare și fără PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Câte 250 de credite. Folosește-le când textul merge în propria ta machetă, aplicație sau newsletter.

Raportul natal știe și un mod mixt: enrich: true adaugă narațiunea AI în interiorul PDF-ului. Pe aceeași hartă de test sunt 5 pagini în loc de 3.