/api/astro/fixed-star/conjunctions/1 krediHaritanızdaki yıldızlar
Bu haritanın gezegenleri üzerinde hangi sabit yıldızların bulunduğu. Asıl sorulan soru budur ve yıldız bazında yapılan bir arama bunu yanıtlayamaz — her yıldızı tek tek alıp hepsini kendiniz karşılaştırmanız gerekirdi. Bir doğum anı ve bir orb verin; temaslar en yakından başlayarak döner ve her birinde, önemini tartabilmeniz için yıldızın kadiri de bulunur. Kavuşum, orb içindeki ekliptik BOYLAMA göre belirlenir; sabit yıldız temasları geleneksel olarak böyle yorumlanır. Ekliptik enlem yanıtta verilir ama bilinçli olarak filtrelemede kullanılmaz: en parlak yıldızların çoğu ekliptikten çok uzaktadır — Algol 22 derece kuzeyde, Sirius 39 derece güneydedir — ve bunları dışarıda bırakmak geleneğin büyük kısmını yok saymak olurdu. Bir derecelik orb zaten geniştir; klasik metinler çok daha dar orb'lar kullanır.
https://api.occultapi.com/api/astro/fixed-star/conjunctions/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. |
| bodies | array | isteğe bağlı | |
| 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. |
| max_magnitude | number (double) | isteğe bağlı | Yalnızca en az bu parlaklıktaki yıldızları tutar. Sayı küçüldükçe parlaklık artar. |
| orb_degrees | number (double) | isteğe bağlı | Ne kadar yakınlığın kavuşum sayılacağı. Bir derece zaten geniş bir orb'dur. min 0.05 · max 5 |
| preset | string | isteğe bağlı | major (varsayılan), behenian, brightest veya all. majorbehenianbrightestall |
| stars | array | isteğe bağlı | Yıldız adları. Gönderilirse `preset` değerinin yerine geçer. |
| 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 |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/fixed-star/conjunctions/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-05-10T19:55:00+05:30","timezone_as_float":5.5,"preset":"major","orb_degrees":1.5}'Yanıt
{
"data": {
"julian_day_ut": 2448022.10069444,
"orb_degrees": 1.5,
"stars_considered": 41,
"count": 6,
"conjunctions": [
{
"body": "mars",
"body_longitude": 344.690843,
"star": "Achernar",
"designation": "alEri",
"magnitude": 0.46,
"star_longitude": 345.172536,
"star_latitude": -59.373354,
"orb": 0.481693,
"sign": "Pisces",
"sign_index": 12,
"degree_in_sign": 15.1725
},
{
"body": "mercury",
"body_longitude": 39.452338,
"star": "Achird",
"designation": "etCas",
"magnitude": 3.44,
"star_longitude": 40.1057,
"star_latitude": 47.009121,
"orb": 0.653362,
"sign": "Taurus",
"sign_index": 2,
"degree_in_sign": 10.1057
},
{
"body": "neptune",
"body_longitude": 284.419553,
"star": "Vega",
"designation": "alLyr",
"magnitude": 0.03,
"star_longitude": 285.190944,
"star_latitude": 61.729236,
"orb": 0.771391,
"sign": "Capricorn",
"sign_index": 10,
"degree_in_sign": 15.1909
},
{
"body": "moon",
"body_longitude": 238.259725,
"star": "Rigil Kentaurus",
"designation": "alCen",
"magnitude": -0.1,
"star_longitude": 239.368967,
"star_latitude": -42.592043,
"orb": 1.109242,
"sign": "Scorpio",
"sign_index": 8,
"degree_in_sign": 29.369
},
{
"body": "uranus",
"body_longitude": 279.296197,
"star": "Facies",
"designation": "M22",
"magnitude": 6.17,
"star_longitude": 278.186132,
"star_latitude": -0.726425,
"orb": 1.110065,
"sign": "Capricorn",
"sign_index": 10,
"degree_in_sign": 8.1861
},
{
"body": "pluto",
"body_longitude": 226.304012,
"star": "Zubenelgenubi",
"designation": "al-2Lib",
"magnitude": 2.75,
"star_longitude": 224.956907,
"star_latitude": 0.334298,
"orb": 1.347105,
"sign": "Scorpio",
"sign_index": 8,
"degree_in_sign": 14.9569
}
]
},
"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.