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}'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.
| 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. |