Reports API - 16 laporan PDF siap pakai dengan merekmu

Kamu mengirim tanggal lahir, kamu menerima dokumen jadi. Bukan JSON yang masih harus disusun menjadi PDF, melainkan PDF itu sendiri: tertata per halaman, dengan logomu, judul laporanmu, dan tanpa satu pun penyebutan tentang kami di dalamnya.

Enam belas laporan seperti ini sudah berjalan. Bersama dispatcher, riwayat ekspor, dan lima naratif AI, totalnya 23 path di bawah /v1/reports/*.

Katalog

Setiap baris memiliki contoh siap pakai. Ini bukan mockup: file dihasilkan oleh panggilan yang sama dengan yang tercetak di referensi endpoint tersebut, dan diterbitkan ulang bersama templatenya.

Jumlah halaman adalah yang dihasilkan oleh contoh tersebut, diukur pada 2026-09-21. Jumlahnya berubah tergantung bagan: lebih banyak aspek berarti lebih banyak baris, dan relocation menambah dua sampai tiga halaman untuk setiap kota (4 halaman untuk satu kota, 13 untuk lima).

Endpoint	Isi	Halaman	Kredit	Contoh
/v1/reports/natal	Big Three, planet, rumah, aspek	3	5 000	PDF
/v1/reports/synastry	Aspek antarbagan dari dua bagan, keseimbangan elemen	2	5 000	PDF
/v1/reports/transit-yearly	Prakiraan transit untuk tahun yang dipilih	5	5 000	PDF
/v1/reports/relocation	Bagan asal, hingga 5 kota, planet yang berpindah rumah, garis di dekatnya, 19 bidang kehidupan	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna dan nakshatra, posisi sidereal, mahadasha Vimshottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, rin yang terdeteksi, upaya	2	5 000	PDF
/v1/reports/gemstone	Rekomendasi batu dengan mantra, batu yang tidak boleh dipakai, kondisi graha	7	5 000	PDF
/v1/reports/human-design	Parameter kunci, pusat, kanal	2	5 000	PDF
/v1/reports/muhurta	Hari baik yang diperingkat untuk satu aktivitas	4	5 000	PDF
/v1/reports/love	Titik kunci cinta, Big Three, aspek	2	5 000	PDF
/v1/reports/career	Titik kunci karier, konteks kepribadian, aspek	2	5 000	PDF
/v1/reports/money	Titik kunci keuangan, rumah, aspek	3	5 000	PDF
/v1/reports/business	Titik kunci bisnis, rumah, aspek	2	5 000	PDF
/v1/reports/child	Ciri karakter utama, Big Three, planet	2	5 000	PDF
/v1/reports/stellaforge	Poster bagan satu halaman: planet, keseimbangan, aspek kunci	1	5 000	PDF
/v1/reports/tarot	Deskripsi bentangan dan kartu	2	100	PDF

Tarot lima puluh kali lebih murah karena tidak ada efemeris di sana: satu halaman bentangan tanpa perhitungan astronomis.

Satu path, bukan enam belas

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

Untuk SDK ini berarti satu metode, bukan dua belas; untuk MCP satu tool, bukan dua belas. Harganya sama: panggilan lewat dispatcher memotong persis sebanyak path langsung.

PDF atau HTML

Secara default yang dikembalikan adalah PDF beserta tautannya. ?format=html mengembalikan halaman HTML jadi langsung di respons, tanpa render dan tanpa penyimpanan: praktis saat kamu menyematkan laporan di halamanmu sendiri atau ingin memakai CSS milikmu.

Tautan PDF berlaku 24 jam. Ini disengaja: kami tidak meng-hosting dokumen orang lain tanpa batas waktu. Ambil file ke sisimu segera setelah respons diterima. GET /v1/reports/history secara gratis menampilkan ekspor terakhir dari kunci ini, dan entri yang sudah kedaluwarsa datang dengan expired: true.

Merekmu, bukan merek kami

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

Objek ini bisa dikirim langsung di permintaan, sehingga tidak perlu 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" } }'

Dokumen yang dihasilkan memuat nama studio, judul laporan sendiri, warna aksen di judul bagian, dan footer milikmu. Kata AstroWay tidak muncul sekali pun di dalamnya.

Alternatif bagi yang tidak ingin mengulang objek di setiap permintaan: whitelabel: true memakai konfigurasi akun yang tersimpan (/v1/whitelabel/config), dan POST /v1/whitelabel/preview menggambar contoh laporan natal dengan konfigurasi tersebut, agar bisa dilihat sebelum ditunjukkan ke klien.

Aplikasi siap pakai yang bisa di-clone

Demo langsung dan kode di GitHub, MIT.

Meja praktisi: data klien di kiri, PDF jadi di kanan. Setiap ubin laporan menampilkan harga dalam kredit sebelum diklik dan mengarah ke contoh jadi. White-label diaktifkan dengan satu centang. Backend-nya adalah satu route tanpa dependensi, karena justru di situlah intinya: browser tidak bisa memanggil API secara 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 layak diambil. Harga ditampilkan di tempat keputusan diambil: server meneruskan X-Credits-Used kembali ke halaman, bukan hanya ke log. Enam belas laporan memiliki empat bentuk permintaan, bukan enam belas. Permintaan yang sama untuk kedua kalinya berbiaya nol, karena cache respons mengembalikan file yang sama. Dan ALLOWED_REPORTS membatasi apa yang mau dirender oleh sebuah instance: demo publik hanya merender bentangan Tarot (/v1/reports/tarot, 100 kredit), karena halaman di internet terbuka yang membuat laporan natal (/v1/reports/natal, 5 000) untuk siapa saja menghabiskan kuota gratis bulanan dalam dua klik.

Bahasa

Field language menerima 21 kode. Yang diterjemahkan sepenuhnya ada tiga: Ukraina, Inggris, Rusia. Untuk delapan belas lainnya, nama zodiak dilokalkan, sedangkan judul dan penjelasan tetap dalam bahasa Inggris: laporan berbahasa Jerman akan menulis “Löwe” di bawah judul “Planets”.

Kami menuliskannya terus terang, karena laporan adalah dokumen yang disimpan klienmu. Menjualnya sebagai laporan berbahasa Jerman setelah melihat nama zodiak berbahasa Jerman di contoh akan menjadi kejutan yang tidak menyenangkan di sisi klien, bukan di sisi kami. Laporan muhurta untuk saat ini seluruhnya berbahasa Inggris.

Perhatian

Diukur pada 2026-09-20. Jika kamu membutuhkan bahasa tertentu secara lengkap, hubungi kami: antrean terjemahan manual berjalan berdasarkan permintaan, bukan berdasarkan daftar.

Berapa laporan yang didapat di setiap paket

/v1/reports/natal dan PDF lainnya berbiaya 5 000 kredit, sehingga kuota bulanan paket dapat dikonversi ke jumlah laporan dengan mudah:

Paket	Kredit/bln	Laporan PDF	Laporan Tarot
Free	10 000	laporan 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	500 000	100	5 000

Di Free laporan sengaja ditutup: satu PDF berarti beberapa detik kerja Chrome di sisi kami, dan paket gratis tidak menanggungnya. Pintu masuk termurah adalah Indie seharga $5.

Reports Pack adalah add-on tersendiri bagi yang hanya membutuhkan laporan: $99 per bulan, 500 000 kredit, yaitu 100 PDF seharga 99 sen per buah, dengan white-label. Kunci paket ini hanya bisa mengakses /v1/reports/* dan /v1/whitelabel/*.

Jika yang dibutuhkan teks, bukan dokumen

Lima endpoint mengembalikan naratif AI sebagai JSON, tanpa tata letak dan tanpa PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. Masing-masing 250 kredit. Pakai ini saat teksnya masuk ke tata letak, aplikasi, atau newsletter milikmu sendiri.

Laporan natal juga mendukung mode campuran: enrich: true menambahkan naratif AI ke dalam PDF. Pada bagan uji yang sama hasilnya 5 halaman, bukan 3.