Reports API: kendi markanızla 16 hazır PDF raporu
Doğum tarihini gönderirsin, hazır belgeyi alırsın. PDF’e dönüştürmen gereken bir JSON değil, sayfa sayfa düzenlenmiş, kendi logon, kendi rapor adın ve içinde bize dair hiçbir bahsi geçmeyen PDF’in kendisi.
On altı rapor zaten çalışıyor. Bir yönetici, dışa aktarma geçmişi ve beş yapay zeka anlatımıyla birlikte, bunlar /v1/reports/* altında 23 yol oluşturuyor.
Katalog
Section titled “Katalog”Her satırın hazır bir örneği var. Bu bir taslak değil: dosya, bu uç noktanın referansında yazılı olan çağrıyla aynı şekilde oluşturulmuş ve şablonlarla birlikte yeniden yayınlanmaktadır.
Sayfa sayısı, bu örneğin verdiği ve 2026-09-21 tarihinde ölçülen sayıdır. Haritaya göre değişir: daha fazla açı daha fazla satır demektir ve relocation her şehir için iki ila üç sayfa ekler (bir şehir için 4 sayfa, beş şehir için 13).
| Uç Nokta | İçerik | Sayfa | Kredi | Örnek |
|---|---|---|---|---|
/v1/reports/natal | Büyük Üçlü, gezegenler, evler, açılar | 3 | 5 000 | |
/v1/reports/synastry | İki haritanın haritalar arası açıları, element dengesi | 2 | 5 000 | |
/v1/reports/transit-yearly | Seçilen yıl için transit tahmini | 5 | 5 000 | |
/v1/reports/relocation | Doğum haritası, 5 şehre kadar, ev değiştiren gezegenler, yakın çizgiler, 19 yaşam alanı | 6 | 5 000 | |
/v1/reports/vedic-kundli | Lagna ve Nakshatra, sideral pozisyonlar, Vimshottari Mahadashalar | 2 | 5 000 | |
/v1/reports/lal-kitab | Kısmet, Teva, tespit edilen Rina’lar, Upayalar | 2 | 5 000 | |
/v1/reports/gemstone | Mantralarla taş tavsiyesi, takılmaması gereken taşlar, grahaların durumu | 7 | 5 000 | |
/v1/reports/human-design | Temel parametreler, merkezler, kanallar | 2 | 5 000 | |
/v1/reports/muhurta | Tek bir aktivite için sıralanmış uygun günler | 4 | 5 000 | |
/v1/reports/love | Aşkın ana noktaları, büyük üçlü, açılar | 2 | 5 000 | |
/v1/reports/career | Kariyerin ana noktaları, kişilik bağlamı, açılar | 2 | 5 000 | |
/v1/reports/money | Ana finansal noktalar, evler, açılar | 3 | 5 000 | |
/v1/reports/business | İşin ana noktaları, evler, açılar | 2 | 5 000 | |
/v1/reports/child | Ana karakter özellikleri, büyük üçlü, gezegenler | 2 | 5 000 | |
/v1/reports/stellaforge | Tek sayfalık harita posteri: gezegenler, denge, ana açılar | 1 | 5 000 | |
/v1/reports/tarot | Açılım ve kartların açıklaması | 2 | 100 | |
/v1/reports/vastu | Mandala ile ev planı, değerlendirme, kaynaklar ve düzeltmelerle Vastu bulguları | 2 | 5 000 |
Tarot elli kat daha az maliyetlidir, çünkü efemeris içermez: astronomik hesaplamalar olmadan tek sayfalık bir açılım.
Derinlik: standard veya extended
Section titled “Derinlik: standard veya extended”/v1/reports/natal (ve report_type: "natal" ile /v1/reports/generate) depth parametresini kabul eder. standard yukarıdaki belgedir, 5000 kredi. extended 10000 kredi maliyetindedir ve harita çarkını ve Güneş’ten Plüton’a, Chiron’a ve Yükselen’e kadar her bir gök cismi için burçtaki bir bölümü ekler: her biri iki ila dört sayfa düzenlenmiş metin içeren on iki bölüm (PDF örneği, 13 sayfa), /v1/natal-texts tarafından sağlanan aynı metin gövdesinden. İstek üzerine hiçbir şey oluşturulmaz, bu nedenle aynı harita aynı belgeyi verir.
Bölümler 20 dilde, sitenin dillerinde mevcuttur; depth: "extended" farklı bir dille 400 hatasıyla reddedilir, başka bir dilden doldurulmaz. Diğer rapor türleri şimdilik tek bir derinliğe sahiptir: uzun bölümleri henüz yazılmamıştır.
On altı yerine tek bir yol
Section titled “On altı yerine tek bir yol”POST /v1/reports/generate report_type alanını kabul eder ve ayrı bir yolun yaptığıyla 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 on iki yerine bir yöntem, MCP için on iki yerine bir araç. Fiyat aynıdır: yönetici aracılığıyla yapılan çağrı, doğrudan yol kadar kredi düşer.
PDF mi HTML mi
Section titled “PDF mi HTML mi”Varsayılan olarak bir PDF ve ona bir bağlantı gelir. ?format=html hazır bir HTML sayfasını doğrudan yanıtta, render etmeden ve depolamadan verir: raporu kendi sayfana gömdüğünde veya kendi CSS’ini uygulamak istediğinde kullanışlıdır.
PDF bağlantısı 24 saat geçerlidir. Müşteriye daha uzun süreli bir bağlantı vermek için ?retain_days=30 (90’a kadar) ekle: dosya o kadar gün boyunca kalacak ve yanıttaki expires_at bunu gösterecektir. Başkalarının belgelerini süresiz olarak barındırmıyoruz ve dosyayı daha erken silmek DELETE /v1/reports/files/{filename} aracılığıyla ücretsiz olarak yapılabilir. Dosya, adıyla birlikte gönderdiğin içeriği içerir, bu nedenle saklama süresi DPA, bölüm 2’de açıklanmıştır. GET /v1/reports/history bu anahtarın son dışa aktarımlarını ücretsiz olarak gösterir ve süresi dolmuş bir kayıt expired: true ile gelir.
Senin markan, bizim değil
Section titled “Senin markan, bizim değil”whitelabel 15 alan içeren 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 iletebilirsin, o zaman 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" } }'Oluşturulan belgede stüdyo adı, kendi rapor başlığı, bölüm başlıklarında vurgu rengi ve altbilgin bulunur. AstroWay kelimesi içinde hiçbir zaman geçmez.
Her istekte nesneyi tekrarlamak istemeyenler için alternatif: whitelabel: true kaydedilmiş hesap yapılandırmasını kullanır. Bunu panelindeki Rapor Markalama sayfasında ayarla: şirket adı, rapor adı, iletişim bilgileri, logo ve iki renk, doğum raporu örneğinin önizlemesiyle birlikte. Aynı ayarlar anahtar aracılığıyla /v1/whitelabel/config ve /v1/whitelabel/logo üzerinden de erişilebilir ve POST /v1/whitelabel/preview PDF’te bir örnek çizer. Nesnede iletilen alan, kaydedilmiş olanın üzerinde önceliğe sahiptir.
Klonlanabilir hazır uygulama
Section titled “Klonlanabilir hazır uygulama”Canlı demo ve GitHub’daki kod, MIT.
Uygulama 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 yönlendirir. White-label bir onay kutusuyla etkinleştirilir. Backend tek bir rotadır ve bağımlılıkları yoktur, çünkü özü budur: tarayıcı API’ye doğrudan erişemez, bu nedenle anahtar sunucuda yaşar.
git clone https://github.com/astroway/starter-practicecd starter-practice && npm installcp .env.example .env # your key goes herenpm run devDikkate alınması gereken dört şey. Fiyat, kararın verildiği yerde gösterilir: sunucu X-Credits-Used’ı sadece loga değil, sayfaya geri gönderir. On altı raporun on altı değil, dört istek formu vardır. Aynı isteği ikinci kez yapmak sıfır maliyetlidir, çünkü yanıt önbelleği aynı dosyayı döndürür. Ve ALLOWED_REPORTS, örneğin neyi render etmeyi kabul edeceğini sınırlar: herkese doğum raporu (/v1/reports/natal, 5 000) oluşturan açık internetteki bir sayfa, aylık ücretsiz limiti iki tıklamayla tüketeceği için, herkese açık demo yalnızca Tarot açılımını (/v1/reports/tarot, 100 kredi) render eder.
Diller
Section titled “Diller”language alanı 21 kod kabul eder. Üçü tamamen çevrilmiştir: Ukraynaca, İngilizce, Rusça. Diğer on sekiz dil için burç adları yerelleştirilirken, başlıklar ve açıklamalar İngilizce kalır: Almanca bir raporda “Planets” başlığının altında “Löwe” yazacaktır.
Bunu açıkça belirtiyoruz, çünkü rapor müşterinin kendine sakladığı bir belgedir. Örnekte Almanca burç adlarını görüp onu Almanca olarak satmak, müşterinin tarafında hoş olmayan bir sürpriz olurdu, bizim tarafımızda değil. muhurta raporu şimdilik tamamen İngilizcedir.
Bir planda kaç rapor alırsın
Section titled “Bir planda kaç rapor alırsın”/v1/reports/natal ve diğer PDF’ler 5.000 kredi maliyetindedir, bu nedenle planın aylık limiti basitçe rapor sayısına dönüştürülür:
| Plan | Kredi/ay | PDF Raporları | Tarot Raporları |
|---|---|---|---|
| Free | 10 000 | raporlar mevcut değil | mevcut değil |
| 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 |
Ücretsiz planda raporlar kasıtlı olarak kapalıdır: bir PDF bizim tarafımızda saniyeler süren Chrome işi demektir ve ücretsiz tarife bunları karşılamaz. En ucuz giriş 5 dolarlık Indie planıdır.
Reports Pack sadece raporlara ihtiyacı olanlar için ayrı bir eklentidir: ayda 99 dolar, 1.500.000 kredi, yani white-label ile tanesi 33 sente 300 PDF. Bu, Pro planından daha ucuzdur, çünkü anahtar raporlar dışında hiçbir yere gitmez. Bu tür bir planın anahtarı yalnızca /v1/reports/* ve /v1/whitelabel/*’e erişir.
Raporları yeniden satmak: bir PDF sana ne kadara mal olur
Section titled “Raporları yeniden satmak: bir PDF sana ne kadara mal olur”Raporları müşterilerine satıyorsan, tek bir sayı önemlidir: kendi hacminde bir PDF sana ne kadara mal olur. Plan limitleri dahilinde bu, plan fiyatının PDF sayısına bölünmesidir. Limit aşımında her PDF, limitin üzerindeki her 10.000 kredi için hesaplanan bir aşım olarak sayılır, bu nedenle 5000 kredilik bir PDF, planın aşım oranının yarısı kadar maliyetlidir.
| Plan | Plandaki PDF | Limit dahilinde PDF fiyatı | Limit aşımında her PDF |
|---|---|---|---|
| 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 |
Yani en ucuz plan, ayda kaç PDF sattığına, aşım dahil olmak üzere bağlıdır:
| Ayda PDF | En ucuz plan | Senin maliyetin | PDF başına |
|---|---|---|---|
| 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 |
Geçiş noktaları: Starter, 16 PDF’ten itibaren Indie’den daha avantajlıdır, Pro, 57’den itibaren Starter’dan, Reports Pack, 187’den itibaren Pro’dan (raporlar dışında hiçbir şeye ihtiyacın yoksa), Business, 367’den itibaren Reports Pack’ten. Pro ve Business ayrıca API’nin geri kalanını da açar, Pack ise sadece raporları ve white-label’ı.
Marjı sen belirlersin. Reports Pack’teki 300 PDF için aylık maliyetin 99 dolardır. Tanesi 9 dolardan 2700 dolar gelir, 99 dolar gider; tanesi 19 dolardan 5700 dolar gelir. Perakende fiyatı önermiyoruz, ancak aritmetik her durumda aynıdır: senin fiyatın eksi 33 sent.
Genişletilmiş doğum raporu standart olandan iki kat daha pahalıdır, bu nedenle yukarıdaki her planda PDF başına iki kat fiyat demektir: Reports Pack’te 0.66 dolar.
İki şey daha gerçek maliyetleri düşürür. Aynı verilerle yapılan tekrar eden bir istek, yanıt önbelleğinden aynı dosyayı döndürür ve hiçbir maliyeti yoktur, bu nedenle raporu iki kez indiren bir müşteri bir kez ödeme yapar. Yıllık plan ise 9 ay fiyatına 12 aydır ve Reports Pack PDF başına 0.25 dolara gelir.
Satış yapmadan önce örnekleri aç: her biri API’nin döndürdüğü dosyanın aynısıdır ve whitelabel ile senin adın ve renklerin varsayılanların yerine geçer.
Belge değil, metin gerekiyorsa
Section titled “Belge değil, metin gerekiyorsa”Beş uç nokta, düzenleme ve PDF olmadan yapay zeka anlatımını 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üzenine, uygulamana veya e-posta bültenine gidecekse bunları kullan.
Doğum raporu karma modu da destekler: enrich: true yapay zeka anlatımını PDF’in içine ekler. Aynı test haritasında bu, 3 yerine 5 sayfa demektir.