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

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

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

Catalog

Fiecare rând are un exemplu gata. Nu este un mockup: fișierul este generat prin aceeași apelare care este tipărită în documentația acestui endpoint și este reîncărcat împreună cu șabloanele.

Numărul de pagini este cel furnizat de acest exemplu, măsurat la 2026-09-21. Fluctuează în funcție de hartă: mai multe aspecte înseamnă mai multe rânduri, iar relocation adaugă 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 treime, planete, case, aspecte	3	5 000	PDF
/v1/reports/synastry	Aspecte interhărți ale 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	Hartă de bază, până la 5 orașe, planete care și-au schimbat casa, linii în apropiere, 19 sfere ale vieții	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna și nakshatra, poziții siderice, mahadashi Vimsottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, rină detectată, upayis	2	5 000	PDF
/v1/reports/gemstone	Recomandare de pietre cu mantre, pietre de evitat, stare de păcat	7	5 000	PDF
/v1/reports/human-design	Parametri cheie, centre, canale	2	5 000	PDF
/v1/reports/muhurta	Zile favorabile rangate pentru o singură activitate	4	5 000	PDF
/v1/reports/love	Puncte cheie ale iubirii, marea treime, aspecte	2	5 000	PDF
/v1/reports/career	Puncte cheie ale carierei, contextul personalității, aspecte	2	5 000	PDF
/v1/reports/money	Puncte cheie financiare, case, aspecte	3	5 000	PDF
/v1/reports/business	Puncte cheie ale afacerii, case, aspecte	2	5 000	PDF
/v1/reports/child	Trăsături cheie ale caracterului, marea treime, planete	2	5 000	PDF
/v1/reports/stellaforge	Poster al hărții pe o pagină: planete, echilibru, aspecte cheie	1	5 000	PDF
/v1/reports/tarot	Descrierea aranjamentului și a cărților	2	100	PDF
/v1/reports/vastu	Planul casei cu mandala, evaluare, descoperiri Vastu cu surse și corecții	2	5 000	PDF

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

Adâncime: standard sau extended

/v1/reports/natal (și /v1/reports/generate cu report_type: "natal") acceptă depth. standard este documentul de mai sus, 5000 credite. extended costă 10000 credite și adaugă roata hărții și o secțiune pentru fiecare corp de la Soare la Pluto, Chiron și Ascendent în semn: doisprezece secțiuni, fiecare pe două-patru pagini de text editat (exemplu PDF, 13 pagini) din același corp care furnizează /v1/natal-texts. Nimic nu se generează la cerere, așa că aceeași hartă dă același document.

Secțiunile sunt în 20 de limbi, limbile site-ului; depth: "extended" cu altă limbă respinge cu 400, și nu se completează din altă limbă. Celelalte tipuri de rapoarte au momentan o singură adâncime: secțiunile lor lungi nu sunt încă scrise.

Un singur traseu în loc de șaisprezece

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

Pentru SDK este o singură metodă în loc de douăsprezece, pentru MCP un singur instrument în loc de douăsprezece. Prețul este același: apelul prin dispatcher scade exact la fel ca și calea directă.

PDF sau HTML

Implicit se primește PDF și un link către el. ?format=html returnează o pagină HTML gata direct în răspuns, fără randare și fără stocare: convenabil când încorporezi raportul în pagina ta sau vrei să adaugi propriul CSS.

Linkul către PDF trăiește 24 de ore. Pentru a oferi clientului un link mai lung, adaugă ?retain_days=30 (până la 90): fișierul va sta atâtea zile, iar expires_at în răspuns va arăta asta. Nu găzduim documente terțe pe termen nelimitat, iar fișierul poate fi șters mai devreme prin DELETE /v1/reports/files/{filename}, gratuit. Fișierul conține ceea ce ai trimis, împreună cu numele, astfel că perioada de stocare este descrisă în DPA, secțiunea 2. GET /v1/reports/history afișează gratuit ultimele exporturi ale acestei chei, și înregistrarea expirată apare 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).

Poate fi transmis direct în cerere, și atunci nu este 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 apare numele studioului, titlul propriu al raportului, culoarea accentului în titlurile secțiunilor și subsolul tău. Cuvântul AstroWay nu apare deloc.

Alternativa pentru cei care nu doresc să repete obiectul în fiecare cerere: whitelabel: true preia configurația salvată a contului. Seteaz-o pe pagina Branding rapoarte în cabinet: numele companiei, numele raportului, contacte, logo și două culori, cu previzualizarea exemplului de raport natal. Aceleași setări sunt accesibile cu cheia prin /v1/whitelabel/config și /v1/whitelabel/logo, iar POST /v1/whitelabel/preview generează un exemplu în PDF. Câmpul transmis în obiect are prioritate față de cel salvat.

Aplicație gata, care poate fi clonată

Demo live și cod pe GitHub, MIT.

Masa practică: datele clientului în stânga, PDF-ul gata în dreapta. Fiecare cărămidă de raport arată prețul în credite înainte de click și duce la exemplul gata. White-label se activează printr-o bifă. Backend-ul este un singur endpoint fără dependențe, deoarece esența este aici: browserul nu poate accesa API-ul direct, așa că cheia trăiește 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 pe care trebuie să le elimini. Prețul este afișat acolo unde se ia decizia: serverul returnează X-Credits-Used înapoi pe pagină, nu doar în log. Șaisprezece rapoarte au patru forme de cerere, nu șaisprezece. Aceeași cerere a doua oară costă zero, deoarece cache-ul răspunsurilor returnează același fișier. Și ALLOWED_REPORTS limitează ce anume instanța va accepta să renderizeze: demo-ul public renderizează doar programul Tarot (/v1/reports/tarot, 100 credite), deoarece pagina pe internet deschis permite oricui să facă raport natal (/v1/reports/natal, 5 000) consumând limita lunară gratuită în două clickuri.

Limbi

Câmpul language acceptă 21 de coduri. Trei sunt traduse complet: ucraineană, engleză, rusă. Pentru celelalte optsprezece, se localizează numele semnelor, iar titlurile și explicațiile rămân în engleză: raportul german va scrie “Löwe” sub titlul “Planets”.

Scriem asta direct, deoarece raportul este un document pe care clientul tău îl păstrează. Să-l vinzi ca german, văzând numele semnelor în germană în exemplu, ar fi o descoperire neplăcută pentru client, nu pentru noi. Raportul muhurta este încă complet în engleză.

Atenție

Măsurat la 2026-09-20. Dacă ai nevoie de o limbă specifică complet, scrie: coada de traduceri manuale merge pe cerere, nu pe listă.

Câte rapoarte obții în plan

/v1/reports/natal și celelalte PDF costă 5 000 credite, așa că limita lunară a planului se traduce simplu în numărul de rapoarte:

Plan	Credite/lună	PDF-uri	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	1 500 000	300	15 000

În planul Free rapoartele sunt închise intenționat: un PDF reprezintă câteva secunde de lucru Chrome pe partea noastră, iar tariful gratuit nu le acoperă. Cel mai ieftin acces este Indie la $5.

Reports Pack este un add-on separat pentru cei care au nevoie doar de rapoarte: $99 pe lună, 1 500 000 credite, adică 300 PDF la 33 de cenți fiecare, cu white-label. Este mai ieftin decât PDF pe Pro, deoarece cheia nu merge nicăieri în afară de rapoarte. Cheia unui astfel de plan merge doar în /v1/reports/* și /v1/whitelabel/*.

Revânzarea rapoartelor: cât îți costă PDF-ul

Dacă vinzi rapoarte clienților tăi, contează un singur număr: cât îți costă un PDF la volumul tău. În limita planului, prețul este prețul planului împărțit la numărul de PDF-uri. Peste limită, fiecare PDF este considerat ca overage, calculat la fiecare 10 000 credite peste limită, așa că un PDF de 5000 credite costă jumătate din rata de overage a planului.

Plan	PDF în plan	Preț PDF în limită	Fiecare PDF peste
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

Deci cel mai ieftin plan depinde de câte PDF-uri vinzi pe lună, inclusiv overage-ul:

PDF pe lună	Cel mai ieftin plan	Cheltuielile tale	Per 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

Punctele de tranziție: Starter devine mai avantajos decât Indie de la 16 PDF, Pro față de Starter de la 57, Reports Pack față de Pro de la 187, dacă nu ai nevoie de altceva decât rapoarte, Business față de Reports Pack de la 367. Pro și Business deblochează și restul API-ului, Pack doar rapoarte și white-label.

Marja o stabilești tu. Pentru 300 PDF în Reports Pack cheltuielile tale sunt $99 pe lună. La $9 pe bucată asta înseamnă $2700 venit versus $99 cheltuieli, la $19 înseamnă $5700. Nu recomandăm prețul de vânzare cu amănuntul, dar aritmetica este aceeași pentru oricare: prețul tău minus 33 de cenți.

Raportul natal extins costă de două ori mai mult decât cel standard, așa că pe fiecare plan de mai sus este dublu prețul pentru PDF: $0.66 în Reports Pack.

Două lucruri reduc și mai mult cheltuielile reale. O cerere repetată cu aceleași date returnează același fișier din cache-ul răspunsurilor și nu costă nimic, așa că clientul care a descărcat raportul de două ori plătește o singură dată. Și planul anual este 12 luni la prețul 9, iar Reports Pack devine $0.25 per PDF.

Înainte de a vinde, deschide exemplele: fiecare este exact fișierul pe care îl returnează API-ul, și cu whitelabel numele și culorile tale înlocuiesc pe cele tipice.

Dacă ai nevoie de text, nu de document

Cinci endpoint-uri returnează narațiunea AI ca JSON, fără layout și fără PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. 250 credite fiecare. Ia-le când textul merge în propriul tău layout, aplicație sau newsletter.

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