POST/api/astro/fixed-star/catalog/1 kredi

Sabit yıldız kataloğu

Sabit yıldız kataloğunda ada, adlandırmaya veya parlaklığa göre arama yapar. Katalog 532 ayrı yıldızı kapsayan 1357 satırdan oluşur; geri kalan satırlar, ait oldukları yıldızın altında toplanmış takma adlardır. Bu önemlidir: Aldebaran aynı zamanda Rohini, Sirius da Lubdhaka'dır; böylece Vedik adlarla da arama yapılabilir ve basit bir listeleme Sirius'u üç kez döndürmez. Yıldız adları tahmin edilemeyeceği için başka bir şey istemeden önce bu dizine bakmanız gerekir. Tarih almaz ve konum döndürmez — konum için tarih gerekir; bunun için /positions/ endpoint'ini kullanın.

https://api.occultapi.com/api/astro/fixed-star/catalog/

İ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
limit	integer	isteğe bağlı	min 1 · max 500
max_magnitude	number (double)	isteğe bağlı
preset	string	isteğe bağlı	`majorbehenianbrightestall`
search	string	isteğe bağlı	Ada veya Bayer adlandırmasına göre eşleştirir.

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/fixed-star/catalog/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search":"aldebaran","preset":"all","limit":25}'

Yanıt

{
  "data": {
    "distinct_stars": 532,
    "matched": 1,
    "returned": 1,
    "stars": [
      {
        "star": "Aldebaran",
        "designation": "alTau",
        "magnitude": 0.86,
        "aliases": [
          "Rohini"
        ]
      }
    ]
  },
  "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.