Reports API: kendi markanızla 16 hazır PDF raporu

Doğum tarihini gönderirsiniz, hazır bir belge alırsınız. Üzerinden PDF dizmeniz gereken bir JSON değil, PDF’in kendisi: sayfa sayfa dizilmiş, sizin logonuzla, sizin rapor adınızla ve içinde bizden tek bir söz olmadan.

Bu raporlardan on altısı şu anda çalışıyor. Dispatcher, dışa aktarma geçmişi ve beş AI anlatısıyla birlikte bu, /v1/reports/* altında 23 yol eder.

Katalog

Her satırın hazır bir örneği var. Bu bir maket değildir: dosya, o endpoint’in başvuru sayfasında basılı olan çağrının aynısıyla üretilmiştir ve şablonlarla birlikte yeniden yayımlanır.

Sayfa sayısı, tam olarak bu örneğin verdiği sayıdır ve 2026-09-21’de ölçülmüştür. Haritaya göre değişir: daha fazla açı daha fazla satır demektir, relocation ise her şehir için iki üç sayfa ekler (tek şehir için 4 sayfa, beş şehir için 13).

Endpoint	İçinde ne var	Sayfa	Kredi	Örnek
/v1/reports/natal	Büyük üçlü, gezegenler, evler, açılar	3	5 000	PDF
/v1/reports/synastry	İki harita arasındaki açılar, element dengesi	2	5 000	PDF
/v1/reports/transit-yearly	Seçilen yıl için transit öngörüsü	5	5 000	PDF
/v1/reports/relocation	Başlangıç haritası, en fazla 5 şehir, ev değiştiren gezegenler, yakındaki çizgiler, 19 yaşam alanı	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna ve nakşatra, sidereal konumlar, Vimşottari mahadaşaları	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, tespit edilen rinler, upayalar	2	5 000	PDF
/v1/reports/gemstone	Mantralarıyla taş önerisi, takılmaması gereken taşlar, grahaların durumu	7	5 000	PDF
/v1/reports/human-design	Temel parametreler, merkezler, kanallar	2	5 000	PDF
/v1/reports/muhurta	Tek bir faaliyet için sıralanmış elverişli günler	4	5 000	PDF
/v1/reports/love	Aşkın temel noktaları, büyük üçlü, açılar	2	5 000	PDF
/v1/reports/career	Kariyerin temel noktaları, kişilik bağlamı, açılar	2	5 000	PDF
/v1/reports/money	Temel finansal noktalar, evler, açılar	3	5 000	PDF
/v1/reports/business	İşin temel noktaları, evler, açılar	2	5 000	PDF
/v1/reports/child	Temel karakter özellikleri, büyük üçlü, gezegenler	2	5 000	PDF
/v1/reports/stellaforge	Tek sayfalık harita posteri: gezegenler, denge, temel açılar	1	5 000	PDF
/v1/reports/tarot	Açılımın ve kartların açıklaması	2	100	PDF

Tarot elli kat daha ucuzdur, çünkü orada efemeris yoktur: astronomik hesaplama içermeyen tek sayfalık bir açılım.

On altı yerine tek yol

POST /v1/reports/generate bir report_type alanı kabul eder ve ayrı yolla aynı şeyi yapar. On iki tür: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

SDK için bu on iki yerine tek bir metot, MCP için on iki yerine tek bir araç demektir. Fiyat aynıdır: dispatcher üzerinden yapılan çağrı, doğrudan yolun düştüğü kadar kredi düşer.

PDF mi HTML mi

Varsayılan olarak bir PDF ve ona giden bir bağlantı gelir. ?format=html hazır HTML sayfasını render ve saklama olmadan doğrudan yanıtta döndürür: raporu kendi sayfanıza gömdüğünüzde veya kendi CSS’inizi uygulamak istediğinizde kullanışlıdır.

PDF bağlantısı 24 saat geçerlidir. Bu bilinçlidir: başkalarının belgelerini süresiz olarak barındırmıyoruz. Dosyayı yanıttan hemen sonra kendi tarafınıza alın. GET /v1/reports/history bu anahtarın son dışa aktarmalarını ücretsiz olarak gösterir ve süresi dolmuş bir kayıt expired: true ile gelir.

Bizim değil, sizin markanız

whitelabel 15 alanlı bir nesne kabul eder: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing ve beş renk (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

Doğrudan istekte gönderilebilir ve bu durumda hiçbir hesap ayarı gerekmez:

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

Üretilen belgede stüdyonun adı, raporun kendi başlığı, bölüm başlıklarında vurgu rengi ve sizin alt bilginiz yer alır. AstroWay kelimesi içinde bir kez bile geçmez.

Nesneyi her istekte tekrarlamak istemeyenler için alternatif: whitelabel: true hesabın kayıtlı yapılandırmasını (/v1/whitelabel/config) kullanır, POST /v1/whitelabel/preview ise müşteriye göstermeden önce bakabilmeniz için onunla bir örnek doğum haritası raporu çizer.

Klonlanabilecek hazır bir uygulama

Canlı demo ve GitHub’daki kod, MIT.

Bir uygulayıcının masası: solda müşteri verileri, sağda hazır PDF. Her rapor kutucuğu tıklamadan önce kredi cinsinden fiyatı gösterir ve hazır bir örneğe götürür. White-label bir onay kutusuyla açılır. Backend bağımlılıksız tek bir rotadır, çünkü asıl mesele de budur: tarayıcı API’ye doğrudan erişemez, bu yüzden anahtar sunucuda yaşar.

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

Ondan almaya değer dört şey. Fiyat kararın verildiği yerde gösterilir: sunucu X-Credits-Used’ı yalnızca loga değil, sayfaya da geri verir. On altı raporun on altı değil, dört istek biçimi vardır. Aynı istek ikinci kez sıfıra mal olur, çünkü yanıt önbelleği aynı dosyayı döndürür. Ve ALLOWED_REPORTS örneğin tam olarak neyi render etmeyi kabul edeceğini sınırlar: herkese açık demo yalnızca Tarot açılımını (/v1/reports/tarot, 100 kredi) render eder, çünkü açık internette herkese doğum haritası raporu (/v1/reports/natal, 5 000) üreten bir sayfa, aylık ücretsiz limiti iki tıkta harcar.

Diller

language alanı 21 kod kabul eder. Tamamen çevrilmiş olanlar üç tanedir: Ukraynaca, İngilizce, Rusça. Diğer on sekizi için burç adları yerelleştirilir, başlıklar ve açıklamalar ise İngilizce kalır: Almanca bir rapor “Planets” başlığının altına “Löwe” yazar.

Bunu açıkça yazıyoruz, çünkü rapor müşterinizin saklayacağı bir belgedir. Örnekte Almanca burç adlarını görüp onu Almanca diye satmak, bizim değil müşterinin tarafında tatsız bir keşif olurdu. muhurta raporu şimdilik tamamen İngilizcedir.

Dikkat

2026-09-20’de ölçülmüştür. Belirli bir dile tamamen ihtiyacınız varsa yazın: elle çeviri kuyruğu bir listeye göre değil, talebe göre ilerler.

Bir planda kaç rapor çıkar

/v1/reports/natal ve diğer PDF’ler 5 000 kredi tutar, bu yüzden planın aylık limiti rapor sayısına kolayca çevrilir:

Plan	Kredi/ay	PDF raporu	Tarot raporu
Free	10 000	raporlar kullanılamaz	kullanılamaz
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

Free’de raporlar bilinçli olarak kapalıdır: tek bir PDF bizim tarafımızda saniyelerce Chrome çalışması demektir ve ücretsiz plan bunu karşılamaz. En ucuz giriş $5’lık Indie’dir.

Reports Pack, yalnızca raporlara ihtiyaç duyanlar için ayrı bir eklentidir: ayda $99, 500 000 kredi, yani white-label ile birlikte tanesi 99 sentten 100 PDF. Bu planın anahtarı yalnızca /v1/reports/* ve /v1/whitelabel/* adreslerine erişir.

Belge değil, metin gerekiyorsa

Beş endpoint AI anlatısını dizgi ve PDF olmadan JSON olarak döndürür: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Her biri 250 kredi. Metin kendi düzeninize, uygulamanıza veya bülteninize gidiyorsa bunları kullanın.

Doğum haritası raporu karma bir mod da sunar: enrich: true, PDF’in içine bir AI anlatısı ekler. Aynı test haritasında bu, 3 yerine 5 sayfa demektir.