Reports API - 16 laporan PDF siap pakai dengan merekmu

Anda mengirimkan tanggal lahir, dan menerima dokumen siap pakai. Tidak JSON yang harus Anda desain menjadi PDF, tetapi PDF yang sudah diatur halamannya, dengan logo Anda, nama laporan Anda, dan tanpa sebutan apa pun tentang kami di dalamnya.

Telah ada 23 cara di bawah /v1/reports/*, termasuk dengan pengelola, sejarah ekspor, dan lima narasi AI.

Katalog

Setiap baris memiliki contoh siap pakai. Ini bukan sketsa: file tersebut dihasilkan oleh panggilan yang sama yang dicetak dalam dokumentasi endpoint ini, dan diterbitkan kembali bersama dengan template.

Jumlah halaman adalah jumlah yang diberikan oleh contoh ini, diukur pada 2026-09-21. Ini bervariasi tergantung pada peta: semakin banyak aspek, semakin banyak baris, dan relocation menambahkan dua hingga tiga halaman untuk setiap kota (4 halaman untuk satu kota, 13 untuk lima kota).

Endpoint	Isi	Halaman	Kredit	Contoh
/v1/reports/natal	Besar Tiga, planet, rumah, aspek	3	5.000	PDF
/v1/reports/synastry	Aspek antar peta dua kartu, keseimbangan elemen	2	5.000	PDF
/v1/reports/transit-yearly	Prediksi transit untuk tahun yang dipilih	5	5.000	PDF
/v1/reports/relocation	Peta awal, hingga 5 kota, planet yang berubah rumah, garis dekat, 19 sfera kehidupan	6	5.000	PDF
/v1/reports/vedic-kundli	Lagna dan nakshatra, posisi sideris, mahadashi Vimshottari	2	5.000	PDF
/v1/reports/lal-kitab	Kismat, tewa, rina yang terdeteksi, upai	2	5.000	PDF
/v1/reports/gemstone	Rekomendasi batu dengan mantra, batu mana yang tidak boleh dipakai, status graha	7	5.000	PDF
/v1/reports/human-design	Parameter kunci, pusat, saluran	2	5.000	PDF
/v1/reports/muhurta	Hari-hari yang menguntungkan yang diurutkan untuk satu aktivitas	4	5.000	PDF
/v1/reports/love	Titik-titik kunci cinta, Besar Tiga, aspek	2	5.000	PDF
/v1/reports/career	Titik-titik kunci karier, konteks kepribadian, aspek	2	5.000	PDF
/v1/reports/money	Titik-titik finansial kunci, rumah, aspek	3	5.000	PDF
/v1/reports/business	Titik-titik bisnis kunci, rumah, aspek	2	5.000	PDF
/v1/reports/child	Ciri-ciri karakter kunci, Besar Tiga, planet	2	5.000	PDF
/v1/reports/stellaforge	Poster peta satu halaman: planet, keseimbangan, aspek kunci	1	5.000	PDF
/v1/reports/tarot	Deskripsi tarikan dan kartu	2	100	PDF
/v1/reports/vastu	Rencana rumah dengan mandala, penilaian, temuan Vastu dengan sumber dan perbaikan	2	5.000	PDF

Tarot jauh lebih murah, karena tidak ada efemerida: satu halaman tarikan tanpa perhitungan astronomi.

Kedalaman: standard atau extended

/v1/reports/natal (dan /v1/reports/generate dengan report_type: "natal") menerima depth. standard adalah dokumen di atas, 5.000 kredit. extended berbiaya 10.000 kredit dan menambahkan roda peta serta bagian untuk setiap benda dari Matahari hingga Pluto, Chiron, dan Ascendant dalam tanda: dua belas bagian, masing-masing dua hingga empat halaman teks yang diedit (contoh PDF, 13 halaman) dari corpus yang sama yang diberikan oleh /v1/natal-texts. Tidak ada yang dihasilkan berdasarkan permintaan, jadi peta yang sama akan menghasilkan dokumen yang sama.

Bagian-bagian tersedia dalam 20 bahasa, bahasa situs; depth: "extended" dengan bahasa lain ditolak dengan 400, bukan diisi dari bahasa lain. Tipe laporan lainnya saat ini hanya memiliki satu kedalaman: bagian panjang mereka belum ditulis.

Satu rute daripada enam belas

POST /v1/reports/generate menerima bidang report_type dan melakukan hal yang sama seperti rute terpisah. Dua belas tipe: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Untuk SDK ini satu metode daripada dua belas, untuk MCP satu alat daripada dua belas. Harga sama: panggilan melalui pengelola mengurangi jumlah yang tepat seperti rute langsung.

PDF, HTML atau Markdown

Setiap tipe laporan, serta pengelola, menerima format: dalam tubuh permintaan atau sebagai ?format= dalam baris permintaan (kirim satu kali; dua nilai berbeda akan memberikan 400). Harga sama di semua tiga, karena Anda membayar untuk dokumen, bukan untuk file di mana dokumen tersebut datang.

format	Apa yang dikembalikan	Disimpan
pdf (default)	JSON dengan url PDF, page_count, dan expires_at	24 jam atau retain_days
html	Dokumen itu sendiri, Content-Type: text/html	tidak disimpan
markdown	Dokumen yang sama dalam Markdown, Content-Type: text/markdown	tidak disimpan

HTML adalah satu file yang mandiri: gaya di dalamnya, roda peta dan rencana Vastu sebagai SVG yang diembed, tanpa skrip dan tanpa font eksternal. Ini halaman yang sama yang dicetak menjadi PDF, dengan blok white-label yang sama: nama perusahaan, nama laporan, warna, dan footer. Tautan eksternal satu-satunya adalah logoUrl Anda, yang tetap sebagai tautan ke gambar HTTPS Anda, sama seperti di PDF. Setiap nama, tempat, dan teks yang Anda kirimkan dieksekusi, jadi nama seperti <img onerror=...> dicetak sebagai teks. Dokumen dapat dimasukkan ke dalam halaman Anda atau dalam iframe.

Markdown memiliki judul, teks, dan tabel yang sama. Tingkat judul disimpan: # adalah nama laporan, ## bagian, ### sub-bagian, dalam urutan yang sama seperti di PDF, sehingga pemisahan baris yang dimulai dengan ## memberikan bagian-bagian. Tabel dalam format GitHub. Gambar (roda, rencana) diabaikan, digantikan dengan satu baris catatan. Setiap karakter yang Markdown atau renderer HTML di dalamnya akan membaca sebagai markup dieksekusi dengan backslash.

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

Tautan ke PDF hidup selama 24 jam. Untuk memberikan klien tautan yang lebih lama, tambahkan ?retain_days=30 (hingga 90): file akan berada selama banyak hari tersebut, dan expires_at dalam respons akan menunjukkan hal itu. Kami tidak menyimpan dokumen asing secara tidak terbatas, dan Anda dapat menghapus file lebih awal melalui DELETE /v1/reports/files/{filename}, gratis. File berisi apa yang Anda kirimkan bersama dengan nama, sehingga jangka waktu penyimpanan dijelaskan dalam DPA, bagian 2. GET /v1/reports/history gratis menunjukkan ekspor-ekspor terakhir dari kunci ini, dan catatan yang kadaluwarsa datang dengan expired: true.

Brand Anda, bukan kami

whitelabel menerima objek dengan 15 bidang: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing, dan lima warna (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

Anda dapat mengirimkannya langsung dalam permintaan, dan tidak perlu melakukan pengaturan akun apa pun:

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

Dalam dokumen yang dihasilkan, nama studio, judul laporan sendiri, warna aksen di judul bagian, dan footer Anda. Kata AstroWay tidak muncul sekali pun.

Alternatif untuk mereka yang tidak ingin mengulang objek dalam setiap permintaan: whitelabel: true mengambil konfigurasi akun yang disimpan. Atur ini di halaman Branding Laporan di dashboard: nama perusahaan, nama laporan, kontak, logo, dan dua warna, dengan preview contoh laporan natal. Pengaturan yang sama tersedia dengan kunci melalui /v1/whitelabel/config dan /v1/whitelabel/logo, dan POST /v1/whitelabel/preview menggambar contoh dalam PDF. Bidang yang dikirim dalam objek memiliki prioritas atas yang disimpan.

Aplikasi siap pakai yang dapat dikloning

Demo hidup dan kode di GitHub, MIT.

Meja praktisi: data klien di sebelah kiri, PDF siap pakai di sebelah kanan. Setiap papan laporan menunjukkan harga dalam kredit sebelum diklik dan mengarahkan ke contoh siap pakai. White-label diaktifkan dengan centang. Backend ini satu rute tanpa dependensi, karena itu intinya: browser tidak dapat mengakses API langsung, jadi kunci tinggal di 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

Empat hal yang patut diambil. Harga ditampilkan di tempat keputusan diambil: server mengembalikan X-Credits-Used kembali ke halaman, bukan hanya dalam log. Enam belas laporan memiliki empat bentuk permintaan, bukan enam belas. Permintaan yang sama kedua kalinya tidak dikenakan biaya, karena cache respons mengembalikan file yang sama. Dan ALLOWED_REPORTS membatasi apa yang instance akan setuju untuk merender: demo publik hanya merender tarikan Tarot (/v1/reports/tarot, 100 kredit), karena halaman di internet terbuka yang membuat laporan natal (/v1/reports/natal, 5.000 kredit) untuk siapa saja akan menghabiskan batas gratis bulanan dalam dua klik.

Bahasa

Bidang language menerima 21 kode. Tiga bahasa terjemahan lengkap: Ukraina, Inggris, Rusia. Untuk sisanya, delapan belas lokalisasi hanya nama tanda, sementara judul dan penjelasan tetap dalam bahasa Inggris: laporan Jerman akan menulis “Löwe” di bawah judul “Planets”.

Kami menulis ini secara langsung karena laporan adalah dokumen yang klien Anda simpan. Menjualnya sebagai laporan Jerman, melihat nama tanda dalam bahasa Jerman dalam contoh, akan menjadi penemuan yang tidak menyenangkan di pihak klien, bukan di pihak kami. Laporan muhurta masih sepenuhnya dalam bahasa Inggris.

Perhatian

Diukur pada 2026-09-20. Jika Anda memerlukan bahasa tertentu secara lengkap, tulislah: antrian terjemahan manual berjalan sesuai permintaan, bukan sesuai daftar.

Berapa banyak laporan yang keluar di rencana

/v1/reports/natal dan sisanya PDF berbiaya 5.000 kredit, jadi batas bulanan rencana dikonversi menjadi jumlah laporan secara langsung:

Rencana	Kredit/bulan	Laporan PDF	Laporan Tarot
Free	10.000	tidak tersedia	tidak tersedia
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

Di Free, laporan ditutup sengaja: setiap PDF adalah detik rendering di pihak kami, dan tarif gratis tidak mencakupnya. Masuk terjangkau terendah adalah Indie seharga $5.

Reports Pack adalah tambahan khusus untuk mereka yang hanya memerlukan laporan: $99 per bulan, 1.500.000 kredit, yaitu 300 PDF seharga 33 sen per unit, dengan white-label. Ini lebih murah daripada PDF di Pro, karena kunci tidak pergi ke mana-mana kecuali untuk laporan. Kunci rencana ini hanya digunakan dalam /v1/reports/* dan /v1/whitelabel/*.

Penjualan ulang laporan: berapa biaya PDF bagi Anda

Jika Anda menjual laporan kepada klien Anda, satu angka yang penting: berapa biaya satu PDF untuk volume Anda. Dalam batas rencana, ini adalah harga rencana dibagi jumlah PDF. Di atas batas, setiap PDF dihitung sebagai overage, yang dihitung untuk setiap 10.000 kredit di atas batas, jadi PDF seharga 5.000 kredit akan biaya setengah tarif overage rencana.

Rencana	PDF dalam rencana	Harga PDF dalam batas	Setiap PDF di atas
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

Jadi rencana terjangkau tergantung pada berapa banyak PDF per bulan yang Anda jual, termasuk overage:

PDF per bulan	Rencana terjangkau	Biaya Anda	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

Titik perubahan: Starter lebih menguntungkan daripada Indie dari 16 PDF, Pro daripada Starter dari 57, Reports Pack daripada Pro dari 187, jika Anda tidak memerlukan apa pun selain laporan, dan Business daripada Reports Pack dari 367. Pro dan Business juga membuka API lainnya, Pack hanya laporan dan white-label.

Margen Anda yang ditentukan. Untuk 300 PDF di Reports Pack, biaya Anda $99 per bulan. $9 per unit ini $2.700 pendapatan melawan $99 biaya, atau $19 ini $5.700. Kami tidak merekomendasikan harga eceran, tetapi aritmetika sama untuk apa pun: harga Anda dikurangi 33 sen.

Laporan natal extended dua kali lebih mahal daripada standar, jadi pada setiap rencana di atas ini adalah harga ganda per PDF: $0.66 di Reports Pack.

Dua hal mengurangi biaya nyata lebih jauh. Permintaan ulang dengan data yang sama mengembalikan file yang sama dari cache respons dan tidak dikenakan biaya, jadi klien yang mengunduh laporan dua kali hanya dibayar sekali. Dan rencana tahunan adalah 12 bulan dengan harga 9, dan Reports Pack menjadi $0.25 per PDF.

Sebelum menjual, buka contoh: setiap contoh adalah file yang sama yang dikembalikan oleh API, dan dengan whitelabel nama dan warna Anda menggantikan yang standar.

Jika dibutuhkan teks, bukan dokumen

Lima endpoint mengembalikan narasi AI sebagai JSON, tanpa layout dan tanpa PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Setiap 250 kredit. Ambil mereka ketika teks masuk ke desain, aplikasi, atau email Anda sendiri.

Laporan natal juga dapat dalam mode campuran: enrich: true menambahkan narasi AI di dalam PDF. Pada peta tes yang sama, ini 5 halaman daripada 3.