/api/astro/fixed-star/catalog/1 क्रेडिटस्थिर तारों का कैटलॉग
स्थिर तारों के कैटलॉग में नाम, पदनाम या चमक से खोजें। 1357 पंक्तियाँ, जिनमें 532 अलग-अलग तारे हैं — बाकी पंक्तियाँ दूसरे नाम हैं, जिन्हें उनके असली तारे के साथ जोड़ दिया गया है। यह यहाँ ज़रूरी है: Aldebaran ही Rohini है और Sirius ही Lubdhaka, इसलिए वैदिक नामों से भी खोजा जा सकता है, और सीधी-सादी सूची में Sirius तीन बार आ जाता। कुछ और माँगने से पहले आपको यही सूची चाहिए, क्योंकि तारों के नामों का अंदाज़ा नहीं लगाया जा सकता। यह कोई तारीख़ नहीं लेता और कोई स्थिति नहीं लौटाता — स्थिति के लिए तारीख़ चाहिए, इसलिए उसके लिए /positions/ इस्तेमाल करें।
https://api.occultapi.com/api/astro/fixed-star/catalog/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| limit | integer | वैकल्पिक | min 1 · max 500 |
| max_magnitude | number (double) | वैकल्पिक | |
| preset | string | वैकल्पिक | majorbehenianbrightestall |
| search | string | वैकल्पिक | नाम या Bayer पदनाम से मिलाएँ। |
उदाहरण अनुरोध
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}'उत्तर
{
"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"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।