/api/astro/star/1 krediSabit yıldızlar
Adı verilen bir sabit yıldızın, standart sabit yıldız kataloğundan alınan konum verileri. Hem Vedik hem Batı astrolojisi birkaç parlak yıldızı (Aldebaran, Regulus, Spica, Antares) işaret noktası olarak kullanır; nakshatralar da adlarını, kendilerini tanımlayan birleşme yıldızları olan yogataralardan alır. Bu endpoint bir yıldızın ekliptik ve ekvatoral koordinatlarını, bunların değişim hızını ve yıldızın parlaklığını verir. `name` değerini geleneksel bir ad (`Aldebaran`, `Regulus`) ya da Bayer adlandırması (`alTau`, `alLeo`) olarak gönderin; eşleştirmede büyük/küçük harf ve boşluklar dikkate alınmaz, başa eklenen virgül ise Bayer biçimini zorunlu kılar. `date_time`, `timezone_as_float` ve istediğiniz `keys` değerlerini ekleyin. Önemli: `keys` dizisinin ilk öğesi `set_default_positions` olmalıdır. Anahtarlar verdiğiniz sırayla çalıştırılır ve her konum anahtarı bu çağrının ayarladığı hesaplama bayraklarına ihtiyaç duyar; o olmadan başarısız olur. Yalnızca doğrudan katalogdan gelen `magnitude` tek başına çalışır. Konumlar sideraldir. `latitude` ve `longitude` kabul edilir ama kullanılmaz; bir sabit yıldızın yer merkezli konumu bulunduğunuz yere bağlı değildir.
https://api.occultapi.com/api/astro/star/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. |
| keys | array | zorunlu | 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. |
| name | string | zorunlu | AldebaranRohiniAlgolAntaresRegulusSiriusSpicaTrappist-1Galactic CenterGal. CenterGreat AttractorVirgo ClusterStandart sabit yıldız kataloğundaki bir sabit yıldız: geleneksel bir ad (Aldebaran, Regulus, Spica) ya da Bayer adlandırması (alTau, alLeo). Eşleştirmede büyük/küçük harf ve boşluklar dikkate alınmaz. Bayer biçimini zorunlu kılmak için başına virgül ekleyin, ör. ',alTau'. Galactic Center gibi yıldız olmayan noktalar dahil yaklaşık 735 geleneksel ad ve 1117 adlandırma kullanılabilir. Tanınmayan bir ad 400 döndürür. |
| timezone_as_float | number (double) | zorunlu | 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 |
| 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. min -89.9 · max 89.9 |
| 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. min -180 · max 180 |
Kullanılabilir anahtarlar (10)
İstediğiniz hesaplamaları keys içinde tek tek sayın; yalnızca onlar hesaplanır. Bilinmeyen tek bir anahtar bile isteğin tamamını reddettirir. Kaç anahtar isterseniz isteyin ücret 1 kredi olur; bu yüzden hepsini tek istekte toplayın.
| Anahtar | Gereken ek alanlar | Açıklama |
|---|---|---|
| declination | date_time | Yıldızın `date_time` anındaki dik açıklığı, yani gök ekvatorunun ne kadar kuzeyinde veya güneyinde olduğu; `{degrees, minutes, seconds}` olarak döner. Dönüşümde mutlak değer alındığı için işaret kaybolur ve güney dik açıklığı kuzey dik açıklığından ayırt edilemez. Yarımküre bilgisine ihtiyacınız varsa bunu yıldızın katalog konumundan alın. |
| distance | date_time | Yıldızın `date_time` anında Dünya'ya uzaklığı; astronomik birim cinsinden, üç ondalık basamağa yuvarlanmış tek bir sayı. |
| ecliptic_speeds | date_time | Yıldızın ekliptik koordinatlarının `date_time` anındaki değişim hızı: `{longitude_speed, latitude_speed, distance_speed}` — ilk ikisi gün başına derece, sonuncusu gün başına astronomik birim cinsinden. Değerler çok küçüktür, çünkü bir sabit yıldızın görünür hareketi yörünge hareketinden değil, presesyon ve öz hareketten kaynaklanır. |
| equatorial_speeds | date_time | Yıldızın ekvatoral koordinatlarının `date_time` anındaki değişim hızı: `{right_ascension_speed, declination_speed, distance_speed}` — ilk ikisi gün başına derece, sonuncusu gün başına astronomik birim cinsinden. |
| latitude | date_time | Yıldızın `date_time` anındaki ekliptik enlemi, yani ekliptik düzleminin ne kadar kuzeyinde veya güneyinde bulunduğu. Üç ondalık basamağa yuvarlanmış tek bir derece değeri olarak döner; güney yönü negatiftir. Bir yıldızı zodyak kuşağının dışında tutan budur; bazı parlak yıldızların bir gezegenle hiçbir zaman tam kavuşum yapmamasının nedeni de budur. |
| longitude | date_time | Yıldızın `date_time` anındaki sideral ekliptik boylamı: 0 ile 360 arasında, üç ondalık basamağa yuvarlanmış tek bir derece sayısı. |
| magnitude | — | Yıldızın katalogdaki görünür görsel kadiri, tek bir sayı. Değer ne kadar düşükse yıldız o kadar parlaktır; örneğin Aldebaran 0.86 olarak döner. Bu endpoint'te ne tarih ne de önceden `set_default_positions` çağrısı gerektiren tek anahtardır. |
| retrograde | date_time | Yıldızın ekliptik boylamının `date_time` anında azalıp azalmadığı: tek bir boolean; `longitude_speed` negatifse true olur. Sabit yıldızlarda bu değer pratikte her zaman false olur, çünkü presesyon yıldızı sideral zodyakta ileri taşır. |
| right_ascension | date_time | Yıldızın `date_time` anındaki sağ açıklığı, yani gök ekvatoru üzerindeki doğu-batı koordinatı; ondalık derece yerine `{hours, minutes, seconds}` olarak döndürülür. |
| set_default_positions | — | Değer değil, mod değiştiricidir: hızlarla birlikte görünür yer merkezli konumları ayarlar. /api/astro/celestial/ üzerindeki aynı adlı anahtardan farklı olarak SIDEREAL bayrağını da açar; bu yüzden bu endpoint'in varsayılanı tropikal değil, sideraldir. null döndürür. `keys` dizisinde ilk sıraya koyun: mod değiştiriciler yalnızca kendilerinden sonra listelenen anahtarlara uygulanır. |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/star/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"name":"Aldebaran","keys":["set_default_positions","magnitude"]}'Yanıt
{
"data": {
"set_default_positions": null,
"magnitude": 0.86
},
"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, istediğiniz her anahtarın adıyla 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.