AstroWay/api v2.260.0 · id
semua sistem normal
// astrology api · POST /v1/ziwei/chart

Zi Wei Dou Shu (Bintang Ungu) API

Tanggal lahir, waktu, dan jenis kelamin menghasilkan seluruh bagan: dua belas istana dengan batangnya, semua empat belas bintang utama, yang pembantu, tiga puluh satu bintang minor, dua belas tahap kehidupan, batas dekade, dan empat transformasi yang ditandai pada bintang yang membawanya.

Endpoint
POST /v1/ziwei/chart
Cost
20 credits
Latency
~130 ms
Tier
Tier 2
// 01 / What it computes

Zi Wei Dou Shu (Bintang Ungu) API

Kelahiran diubah menjadi tanggal lunar, karena Zi Wei adalah sistem yang sepenuhnya lunar dan, tidak seperti BaZi, tidak beralih ke istilah matahari. Dari bulan lunar dan jam ganda endpoint menempatkan istana jiwa dan istana tubuh, kemudian memberi batang setiap istana dengan aturan lima harimau, lalu membaca kelas lima elemen dari pilar istana jiwa. Kelas itu dan hari lunar menempatkan 紫微 menurut aturan pinjam-dan-bagi klasik, enam bintang serinya mengikuti dengan offset tetap, 天府 memantulkannya melintasi sumbu 寅-申 dan membawa delapan miliknya. Di atas kerangka itu ada enam bintang keberuntungan dan enam bintang malefik, toko gaji dan kuda surgawi, tiga puluh satu bintang minor yang dikaitkan dengan batang tahun, cabang tahun, bulan, hari, dan jam, dua belas tahap kehidupan, siklus sarjana, siklus umum dan siklus tahun, batas sepuluh tahun yang dibuka pada nomor kelas, dan batas tahunan jika kamu minta usia. Empat transformasi diselesaikan dari batang tahun dan ditempelkan pada bintang itu sendiri bukan dikembalikan sebagai daftar terpisah.

// 02 / Live request

POST/v1/ziwei/chart

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2000-08-16",
    "time": "04:00:00",
    "gender": "male",
    "age": 25
  }'
Response (excerpt)
{
  "ok": true,
  "data": {
    "fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
    "soulPalace": { "index": 4, "branch": "Wu" },
    "bodyPalace": { "index": 8, "branch": "Xu" },
    "ziwei": { "index": 4, "branch": "Wu" },
    "annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
    "palaces": [
      {
        "branch": "Wu",
        "pillar": "Ren-Wu",
        "palace": "destiny",
        "isSoul": true,
        "majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei" }],
        "lifeStage": { "chinese": "死", "name": "Death" },
        "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date. It is converted to a lunar date, because Zi Wei is a lunar system.
time string (HH:MM:SS) yes Local clock time. Required: the soul palace is placed from the double-hour, so a chart without it would be twelve palaces of confident nonsense rather than a partial answer.
gender string yes male or female. It sets the direction of the twelve life stages, the scholar cycle and the decade limits, so the chart cannot be built without it.
age number no Return the annual-limit palace for this age. Omit and the field comes back null.
yearDivide string no lunar (default: the year opens on day one of the first lunar month) or lichun (the BaZi boundary, for reconciling against a calculator that imported it).
fixLeap boolean no Split a leap month at day 15 (default) or count the whole of it as the month it follows.
dayDivide string no forward (default: 23:00 belongs to the next day) or current (keep the date and mark the hour as the late Zi).
school string no The 四化 table: zhongzhou (default), quanji, quanshu or beipai. The four disagree on three of the ten year stems.
language string no Any of 21 codes. Palace names and life-stage names come back translated; star names stay as characters with an English gloss.
// 04 / When to use it

When to use it

Gunakan ini saat kamu membuat produk astrologi Cina untuk pasar yang tidak membaca bahasa Cina: aplikasi, layanan bacaan, renderer bagan, agen yang butuh struktur sebelum menginterpretasi. Responsnya hanya struktur tanpa prosa, jadi mudah dimasukkan ke grid dua belas istana, generator laporan, atau prompt LLM. Endpoint referensi dalam keluarga yang sama lebih murah dan berguna untuk glosarium dan tooltip, tapi mereka mengembalikan tabel yang sama untuk setiap kelahiran dan menyebutnya di sebuah field, jadi jangan buat bagan dari mereka.

// 05 / Notes

Notes

Dipatok pada tiga bagan yang dipublikasikan bukan satu pustaka, sengaja: hampir seluruh ekosistem Zi Wei open-source turun dari satu proyek, jadi setuju dengan beberapa berarti setuju dengan satu. Dua bagan lengkap direproduksi persis, dan yang ketiga berasal dari teks ajaran yang tidak terkait. Empat saklar sekolah berada di body permintaan bukan di kode kami, karena masing-masing menggeser seluruh bagan untuk kelahiran yang dipengaruhi: batas tahun, bulan kabisat, pergantian jam 23:00, dan tabel transformasi. Saat kalkulator lain tidak cocok, periksa empat itu sebelum menghitung.

Try the Zi Wei Dou Shu API

Grab a key and make your first call in under a minute.

99.9% SLA · paket berbayar · 30d status →