/api/astro/chinese/four-pillars/1 krediÇin Dört Sütun haritası (BaZi)
Bir doğumun dört sütunu: yıl, ay, gün ve saat. Her sütun, bir dünyevi dalın üzerinde duran bir göksel gövdeden oluşur; bu ikisinin altmış farklı birleşimi altmışlı döngüyü meydana getirir. Günün gövdesi GÜN EFENDİSİDİR — haritanın en önemli unsurudur, çünkü geri kalan her şey onunla ilişkisine göre okunur. Çin yılı LICHUN anında başlar: Güneş'in tropikal boylamda 315 dereceye ulaştığı an, yani 4 Şubat civarı. 1 Ocak'ta başlamaz; Çin Yeni Yılı'nda da başlamaz — o, 21 Ocak ile 20 Şubat arasında yer değiştiren bir kameri tarihtir ve haritayı değil bayramı belirler. 20 Ocak 2024'te doğan birinin yıl sütunu 2023'ün sütunudur: Ahşap Ejderha değil, Su Tavşanı. Özensiz uygulamaların yanlış yaptığı tek şey budur ve ocak ayında doğan herkesin yılını yanlış belirler. Ay sütunları da aynı şekilde on iki ana güneş dönemiyle sınırlanır; bu yüzden ay sınırı astronomik bir andır ve takvim ayının ilk gününe değil, herhangi bir günün herhangi bir saatine denk gelebilir. Uygulayıcılar bu konularda gerçekten farklı yollar izlediği ve ikisi de sonucu değiştirdiği için iki ayar sunulur. `day_boundary`, günün 23:00'te mi (geleneksel) yoksa gece yarısı mı değişeceğini belirler. `true_solar_time`, saati doğum yerinin saat dilimi meridyenine uzaklığına göre düzeltir — Pekin için yaklaşık on dört dakika — ve bu, saat sütununu bir sıra kaydırabilir.
https://api.occultapi.com/api/astro/chinese/four-pillars/Kimlik doğrulama
Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonİstek alanları
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| date_time | string (date-time) | zorunlu | Hesaplamanın yapılacağı an, ISO 8601 biçiminde. Değere HER ZAMAN bir saat farkı ya da sonda Z ekleyin - saat dilimi içermeyen bir değer UTC değil, Asia/Kolkata (UTC+05:30) olarak okunur ve 200 koduyla bir önceki günün sonucunu döndürebilir. '2026-09-01T06:00:00Z' ile '2026-09-01 06:00:00' farklı anlardır ve farklı sonuç verir. |
| day_boundary | string | isteğe bağlı | Gün sütununun hangi anda değiştiği. 'zi_hour' geleneksel kural olan 23:00'ü, 'midnight' ise çoğu yazılımın kullandığı gece yarısını esas alır. 23:00 ile 24:00 arasındaki doğumlarda ikisi farklı sonuç verir. zi_hourmidnight |
| keys | array | isteğe bağlı | Döndürülecek hesaplamaların adlarını içeren liste. Bu endpoint'in anahtar tablosuna bakın; tanınmayan bir ad varsa isteğin tamamı reddedilir. Kaç anahtar isterseniz isteyin bir çağrı bir kredi tutar; bu yüzden birkaç ayrı çağrı yapmak yerine ihtiyacınız olan her şeyi tek seferde isteyin. |
| latitude | number (double) | isteğe bağlı | Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin. |
| longitude | number (double) | isteğe bağlı | Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer. |
| orb_factor | number (double) | isteğe bağlı | Tüm açı orb'larını ölçekler. 0.5 orb'ları yarıya indirir, 2 iki katına çıkarır. min 0.1 · max 2 |
| timezone_as_float | number (double) | isteğe bağlı | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir. min -12 · max 14 |
| true_solar_time | boolean | isteğe bağlı | Saati, boylamın saat dilimi meridyeninden ne kadar uzak olduğuna göre düzeltir. Geleneksel uygulama gerçek yerel güneş zamanını kullanır; bu düzeltme saat sütununu bir sıra kaydırabilir. |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/chinese/four-pillars/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1984-06-15T14:30:00+08:00","latitude":39.9042,"longitude":116.4074,"timezone_as_float":8}'Yanıt
{
"data": {
"system": "Chinese Four Pillars (BaZi)",
"local_time": "1984-06-15T14:30:00+08:00",
"true_solar_correction_minutes": 0,
"chinese_year": 1984,
"year_begins_at_lichun": "1984-02-04T15:18:45+00:00",
"solar_month": {
"number": 5,
"term": "Mangzhong (grain in ear)",
"began_at": "1984-06-05T12:08:37+00:00",
"ends_at": "1984-07-06T22:29:07+00:00"
},
"day_master": {
"index": 7,
"name": "Geng",
"pinyin": "geng",
"element": "metal",
"polarity": "yang"
},
"pillars": [
{
"pillar": "year",
"stem": {
"index": 1,
"name": "Jia",
"pinyin": "jia",
"element": "wood",
"polarity": "yang"
},
"branch": {
"index": 1,
"name": "Zi",
"animal": "Rat",
"element": "water",
"polarity": "yang"
},
"name": "Jia-Zi",
"animal": "Rat",
"hidden_stems": [
{
"index": 10,
"name": "Gui",
"pinyin": "gui",
"element": "water",
"polarity": "yin"
}
]
},
{
"pillar": "month",
"stem": {
"index": 7,
"name": "Geng",
"pinyin": "geng",
"element": "metal",
"polarity": "yang"
},
"branch": {
"index": 7,
"name": "Wu",
"animal": "Horse",
"element": "fire",
"polarity": "yang"
},
"name": "Geng-Wu",
"animal": "Horse",
"hidden_stems": [
{
"index": 4,
"name": "Ding",
"pinyin": "ding",
"element": "fire",
"polarity": "yin"
},
{
"index": 6,
"name": "Ji",
"pinyin": "ji",
"element": "earth",
"polarity": "yin"
}
]
},
{
"pillar": "day",
"stem": {
"index": 7,
"name": "Geng",
"pinyin": "geng",
"element": "metal",
"polarity": "yang"
},
"branch": {
"index": 5,
"name": "Chen",
"animal": "Dragon",
"element": "earth",
"polarity": "yang"
},
"name": "Geng-Chen",
"animal": "Dragon",
"hidden_stems": [
{
"index": 5,
"name": "Wu",
"pinyin": "wu",
"element": "earth",
"polarity": "yang"
},
{
"index": 2,
"name": "Yi",
"pinyin": "yi",
"element": "wood",
"polarity": "yin"
},
{
"index": 10,
"name": "Gui",
"pinyin": "gui",
"element": "water",
"polarity": "yin"
}
]
},
{
"pillar": "hour",
"stem": {
"index": 10,
"name": "Gui",
"pinyin": "gui",
"element": "water",
"polarity": "yin"
},
"branch": {
"index": 8,
"name": "Wei",
"animal": "Goat",
"element": "earth",
"polarity": "yin"
},
"name": "Gui-Wei",
"animal": "Goat",
"hidden_stems": [
{
"index": 6,
"name": "Ji",
"pinyin": "ji",
"element": "earth",
"polarity": "yin"
},
{
"index": 4,
"name": "Ding",
"pinyin": "ding",
"element": "fire",
"polarity": "yin"
},
{
"index": 2,
"name": "Yi",
"pinyin": "yi",
"element": "wood",
"polarity": "yin"
}
]
}
],
"note": "The year pillar turns at Lichun (Sun at 315 degrees, about 4 February), not on 1 January and not at Chinese New Year, which is a lunar date and governs the festival rather than the chart."
},
"status": 200,
"is_error": false,
"message": "successful"
}Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.
Hatalar
Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.