API metafisika Tiongkok

53 endpoint dalam empat keluarga: BaZi (18), kalender dan zodiak Tiongkok (15), Zi Wei Dou Shu (14), dan I Ching (6). Kalender diturunkan dari efemeris, bukan dari tabel tanggal, sehingga berlaku untuk tahun 2 hingga 2899 dan tidak bergantung pada apakah seseorang sudah memperbarui tabel referensinya.

Apa saja yang termasuk

Keluarga	Endpoint	Status
BaZi: pilar dan analisis	18	Perangkat klasik lengkap
Kalender, zodiak, feng shui, Tong Shu	15	Diturunkan dari efemeris
Zi Wei Dou Shu	14	Penempatan bintang dihitung, sebelas tabel referensi tetap sebagai referensi
I Ching	6	Heksagram, lemparan koin, garis berubah

Apa bedanya dengan library gratis

Jawaban jujurnya: jika yang kamu butuhkan hanya empat pilar, pakai lunar-typescript. Library itu berlisensi MIT, menghitung di dalam proses milikmu, offline, tanpa batas frekuensi, dan tidak perlu dibayar.

Perbedaannya dimulai di tempat library itu berhenti.

Apa	Library MIT	AstroWay API
Empat pilar, 藏干, 纳音, 十神	ya	ya
神煞 dengan kedua pembacaan saat aliran berbeda pendapat	tidak	ya
Interaksi cabang 刑冲合害	tidak	ya
Kekuatan Day Master dalam kerangka 扶抑	tidak	ya
Waktu matahari sejati sebagai perhitungan terpisah	tidak	ya
Bintang terbang berdasarkan arah duduk dan fasad, angka Gua	tidak	ya
Pemilihan tanggal Tong Shu dengan filter aktivitas	tidak	ya
Dua puluh satu bahasa	tidak	ya
Satu konvensi untuk PHP, JavaScript, dan Python sekaligus	tidak	ya

Baris terakhir itulah yang biasanya dibayar. Tim yang situsnya berbasis PHP, aplikasinya JavaScript, dan cron-nya Python, tanpa ini harus memelihara tiga implementasi batas tahun, dan cepat atau lambat mendapatkan tiga jawaban berbeda untuk satu tanggal lahir.

Konvensi disebutkan secara terbuka

Empat sumbu tempat kalkulator berbeda pendapat, dan tidak satu pun merupakan kesalahan. Sebagian besar implementasi memilih diam-diam; kami menuliskan pilihannya di respons dan memelihara halaman konvensi yang diuji terhadap dataset CC0 eksternal.

Sumbu	Jawaban kami
Batas tahun	立春 Lichun, momen tepat dari efemeris
Batas hari	23:00, 子時 awal termasuk hari berikutnya
Waktu matahari sejati	nonaktif secara default, diaktifkan dengan flag
Waktu musim panas	diselesaikan oleh timezoneOffset yang dikirim klien

Contoh

curl

curl -X POST https://api.astroway.info/v1/bazi/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

TypeScript

import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const r = await aw.client.POST('/bazi/chart', {
  body: { date: '1990-05-15', time: '14:30:00', timezoneOffset: 3 },
});
console.log(r.data?.data?.pillars.map((p) => p.pillar));
// [ 'Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei' ]

Python

import os
from astroway import Astroway

aw = Astroway(api_key=os.environ["ASTROWAY_API_KEY"])

chart = aw.post("/bazi/chart", body={
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
})
print([p["pillar"] for p in chart["pillars"]])
# ['Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei']

Metode bertipe

Route analitik BaZi muncul setelah rilis SDK saat ini, sehingga metode bertipe aw.bazi.chart(...) belum tersedia. Contoh di atas memakai klien mentah, yang sudah bekerja dengan path apa pun hari ini. Wrapper bertipe akan hadir di rilis SDK berikutnya.

Aplikasi siap pakai yang bisa di-clone

Demo langsung dan kode di GitHub, MIT.

Dua panggilan, POST /v1/bazi/chart seharga 20 kredit dan POST /v1/bazi/luck-pillars seharga 10, mengembalikan empat pilar dengan batang tersembunyi, nayin, dan dua belas tahap, Day Master dengan vonis kekuatannya, keseimbangan elemen, bintang simbolis, interaksi cabang, dan siklus sepuluh tahunan Da Yun. Aplikasi menggambarnya: tahun di kanan, seperti penulisan klasik, kolom hari ditandai. 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-bazi
cd starter-bazi && npm install
cp .env.example .env     # your key goes here
npm run dev

Tiga hal yang layak diambil darinya. Kirim nama zona, bukan offset: Asia/Shanghai pada 1990-05-15 adalah UTC+9, karena Tiongkok memberlakukan waktu musim panas dari 1986 hingga 1991. Kirim bahasa: defaultnya bahasa Ukraina, dan halaman berbahasa Inggris tanpa parameter ini akan menerima nama elemen dalam bahasa yang salah. Kirim jenis kelamin: Da Yun berjalan maju atau mundur tergantung padanya, nilai netral tidak ada.

Bahasa

Hewan, elemen, yin dan yang, istana, dan dua belas tahap diterjemahkan ke 21 bahasa. Tambahkan ?lang=es, dan field *Name akan muncul di samping token bahasa Inggris. Field bahasa Inggris tidak pernah berubah: lokalisasi menambahkan, bukan mengganti.

Batang, cabang, nama bintang, dan 纳音 sengaja tidak diterjemahkan: nama internasionalnya adalah pinyin di samping aksaranya.

Bagian dokumentasi

Ikhtisar Apa yang dihitung, apa yang tidak, dan mengapa.

BaZi: empat pilar Delapan belas endpoint dan lima tempat aliran berbeda pendapat.

Zodiak dan kalender Tiga hewan, tanggal lunar, dua puluh empat term surya.

Zi Wei Dou Shu Penempatan bintang, dua belas istana, dan empat sakelar aliran.

Konvensi Empat sumbu dan pengujian terhadap dataset eksternal.

Pertanyaan umum Waktu lahir tidak diketahui, waktu matahari sejati, status Zi Wei.

Bintang terbang Sembilan istana, periode, arah duduk, dan fasad.