POST/api/astro/chinese/zodiac/1 kredi

Çin burcu

Hayvan, elementi ve kimlerle iyi anlaştığı. Hayvan yıl DALINDAN, element ise yıl GÖVDESİNDEN gelir — bir Ahşap Ejderha'yı Toprak Ejderha'dan ayıran ve döngünün on iki değil altmış yılda tamamlanmasını sağlayan budur. Ç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. Yanıtta ayrıca şunlar bulunur: hayvanla aynı üçgende yer alan ve gelenekte doğal müttefikleri sayılan iki dal ile çatıştığı, tam karşısındaki dal. Bunlara ek olarak ay ve saat dallarından gelen iç ve gizli hayvanlar — yıl hayvanı kişinin başkalarına görünen yüzüdür, bu ikisinin ise kişinin özüne daha yakın olduğu kabul edilir.

https://api.occultapi.com/api/astro/chinese/zodiac/

İsteği deneyin

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/zodiac/ \
  -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 zodiac",
    "chinese_year": 1984,
    "year_begins_at_lichun": "1984-02-04T15:18:45+00:00",
    "animal": "Rat",
    "element": "wood",
    "polarity": "yang",
    "sign": "Wood Rat",
    "year_pillar": "Jia-Zi",
    "allies": [
      "Dragon",
      "Monkey"
    ],
    "clash": "Horse",
    "inner_animal": {
      "animal": "Horse",
      "from": "month branch",
      "meaning": "Traditionally read as the private self."
    },
    "secret_animal": {
      "animal": "Goat",
      "from": "hour branch",
      "meaning": "Traditionally read as the innermost self."
    },
    "note": "The animal follows the year branch and the year turns at Lichun, about 4 February. A January birth carries the PREVIOUS year's animal."
  },
  "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.