जावास्क्रिप्ट में ज्योतिष API को ज़ाइला API हब का उपयोग करके एकीकृत करें (गाइड)

आपको एक जावास्क्रिप्ट एकीकरण भेजने की आवश्यकता है जो दैनिक, साप्ताहिक, या दिनांकित ज्योतिष को बिना बिखरे स्रोतों या कस्टम स्क्रैपर्स के साथ संघर्ष किए बिना लौटाता है। इस गाइड के अंत तक, आप जावास्क्रिप्ट से ज़ाइला API हब पर ज्योतिष API को क्वेरी करेंगे, इसके JSON को पार्स करेंगे, और इसे आत्मविश्वास के साथ अपने UI या वर्कफ़्लो में प्लग करेंगे।

आप ज्योतिष API के साथ क्या बना सकते हैं

ज्योतिष API समर्थित सूर्य राशियों के लिए कई समय सीमाओं में पाठ ज्योतिष प्रदान करता है। आप:

• विशिष्ट सूर्य राशि के लिए आज का ज्योतिष प्राप्त करें।
• साप्ताहिक या मासिक ज्योतिष, या सप्ताह के दिन के रूपांतर प्राप्त करें।
• एक सूर्य राशि के लिए ऐतिहासिक या विशिष्ट-तारीख सामग्री प्राप्त करें।
• जांचें कि कौन सी सूर्य राशियाँ और समय सीमाएँ उपलब्ध हैं।

सामान्य उपयोग के मामले में जीवनशैली ऐप्स में ऑनबोर्डिंग प्रवाह, सामग्री साइटों पर विजेट, उपयोगकर्ताओं की सूर्य राशियों के आधार पर CRM नजर्स, और चैट सहायक संकेत शामिल हैं जो उपयोगकर्ता सत्रों को ताजे ज्योतिष पाठ के साथ समृद्ध करते हैं।

ज़ाइला API हब पर शुरुआत करना

ज़ाइला API हब एक खाते, एक API कुंजी, और एकल सदस्यता मॉडल के तहत 10,000 से अधिक सार्वजनिक APIs को केंद्रीकृत करता है। शुरू करने के लिए:

1. ज़ाइला पर ज्योतिष API पृष्ठ खोलें।
2. सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें)। ज़ाइला पर, पहला API आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। उत्पादन उपयोग के लिए कोई मुफ्त योजना नहीं है।
3. अपनी API कुंजी कॉपी करें और इसे नीचे दिखाए गए प्राधिकरण हेडर के साथ उपयोग करें।

प्रत्येक कॉल के लिए प्रमाणीकरण प्रारूप: Authorization: Bearer YOUR_API_KEY

आप जिन एंडपॉइंट्स का उपयोग करेंगे

ज्योतिष API ज़ाइला हब पर तीन HTTP GET एंडपॉइंट्स को उजागर करता है। सभी अनुरोधों में प्राधिकरण हेडर की आवश्यकता होती है। यदि कोई पैरामीटर नीचे सूचीबद्ध नहीं है, तो इसे शामिल न करें।

1) ज्योतिष प्राप्त करें

दिए गए सूर्य राशि और समय सीमा के लिए आज का, साप्ताहिक, मासिक, या सप्ताह के दिन का ज्योतिष प्राप्त करें।

• विधि: GET
• URL: https://zylalabs.com/api/891/horoscope-api/694/get-horoscope
• आवश्यक क्वेरी पैरामीटर:
  • sunsign (string): gemini
  • timeframe (string): daily
• विवरण: आज का, साप्ताहिक, मासिक, और सप्ताह के किसी भी दिन का ज्योतिष प्राप्त करें। उस संकेत और ज्योतिष की घोषणा करें जिसे आप प्राप्त करना चाहते हैं। समर्थित समय सीमाओं और सूर्य राशियों की जांच करने के लिए प्रतीकों एंडपॉइंट का उपयोग करें।

आधिकारिक cURL उदाहरण:

curl -s -X GET "https://zylalabs.com/api/891/horoscope-api/694/get-horoscope?sunsign=gemini&timeframe=daily" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक JSON प्रतिक्रिया:

{
"status": 200,
"success": true,
"sunSigns": "gemini",
"timeFrames": "daily",
"Horoscope": "September 2, 2026 - Is it time to serve up those walking papers? With the moon in your twelfth house of healing and closure, the moment has come to cut ties with a toxic situation. That's never as easy as it sounds, so lean on the people who have your back, whether that’s a relative or a member of your chosen family. The moon is forming a supportive trine to Mercury in your homey fourth house, which puts self-care near the top of your priorities today. Considering a move? Scroll the listings on your lunch break, but sleep on anything that requires a signature."
}

इस पेलोड से क्या पढ़ें:

• status और success: आपके एकीकरण के लिए त्वरित मानसिकता जांचें।
• sunSigns और timeFrames: आपके अनुरोध संदर्भ की गूंज।
• Horoscope: आपके UI में प्रदर्शित करने के लिए पाठ सामग्री।

2) प्रतीक प्राप्त करें

समर्थित सूर्य राशियों और उपलब्ध समय सीमाओं की जांच करें।

• विधि: GET
• URL: https://zylalabs.com/api/891/horoscope-api/2450/get-symbols
• अनुरोध पैरामीटर: कोई भी प्रलेखित नहीं।
• विवरण: सूर्य राशियों और समय सीमाओं के ऐरे लौटाता है जिन्हें आप ज्योतिष प्राप्त करें या दिनांक द्वारा पास कर सकते हैं।

आधिकारिक cURL उदाहरण:

आधिकारिक JSON प्रतिक्रिया:

3) दिनांक द्वारा

विशिष्ट तिथि द्वारा आज और पिछले ज्योतिष प्राप्त करें।

• विधि: GET
• URL: https://zylalabs.com/api/891/horoscope-api/3527/by-date
• आवश्यक क्वेरी पैरामीटर:
  • sunsign (string): gemini
  • date (string): 2024-01-02
• विवरण: जब आपको दिए गए सूर्य राशि और तिथि के लिए निश्चित सामग्री की आवश्यकता हो तो इसका उपयोग करें।

आधिकारिक cURL उदाहरण:

आधिकारिक JSON प्रतिक्रिया:

जावास्क्रिप्ट एकीकरण: 10 लाइनों के तहत प्राप्त करें

निम्नलिखित उदाहरण दैनिक समय सीमा के लिए जेमिनी के लिए ज्योतिष प्राप्त करता है। इसमें न्यूनतम त्रुटि हैंडलिंग शामिल है और उन फ़ील्ड को निकालता है जिन्हें आप प्रदर्शित करेंगे। चलाने से पहले YOUR_API_KEY को बदलें।

// JavaScript (Node.js या आधुनिक ब्राउज़र)
// एंडपॉइंट: ज्योतिष प्राप्त करें (दैनिक जेमिनी)
const url = "https://zylalabs.com/api/891/horoscope-api/694/get-horoscope?sunsign=gemini&timeframe=daily";

async function getDailyGemini() {
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});

if (!res.ok) {
// Non-2xx HTTP status: log or throw
const text = await res.text();
throw new Error(`HTTP ${res.status}: ${text}`);
}

const data = await res.json();
if (!data.success) {
throw new Error("API returned success=false");
}

// Fields available per sample:
const sign = data.sunSigns; // "gemini"
const frame = data.timeFrames; // "daily"
const text = data.Horoscope; // Horoscope text content

return { sign, frame, text };
}

// Example usage:
getDailyGemini()
.then(({ sign, frame, text }) => {
console.log(`[${sign} | ${frame}]`);
console.log(text);
})
.catch(err => {
console.error("ज्योतिष प्राप्त करने में विफल:", err.message);
});

उत्पादन उपयोग के लिए नोट्स

• प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY पास करें। अपने कुंजी को क्लाइंट-साइड कोड में एम्बेड न करें बिना एक्सपोजर पर विचार किए; यदि आवश्यक हो तो अपने बैकएंड के माध्यम से प्रॉक्सी कॉल करें।
• कैशिंग: दैनिक, साप्ताहिक, और मासिक सामग्री अधिकांश कार्यान्वयनों में दिन के भीतर नहीं बदलती; कॉल और विलंबता को कम करने के लिए सूर्य राशि/समय सीमा के अनुसार प्रतिक्रियाओं को कैश करें। समय सीमा की बारीकी (जैसे, दैनिक कैश आपके द्वारा चुने गए रोलओवर समय पर रीसेट होता है) के आधार पर कैश को समाप्त करें। दिनांक द्वारा, अपरिवर्तनीय तिथियों के लिए अनिश्चितकाल के लिए कैश करें।
• पैरामीटर: केवल प्रलेखित पैरामीटर भेजें:
  • ज्योतिष प्राप्त करें: सूर्य राशि, समय सीमा।
  • प्रतीक प्राप्त करें: कोई नहीं।
  • दिनांक द्वारा: सूर्य राशि, तिथि।
• पाठ हैंडलिंग: ज्योतिष फ़ील्ड सामान्य पाठ है। इसे जैसा है वैसा प्रदर्शित करें या अपने UI में स्वच्छता/फॉर्मेट करें। एकल उद्धरण और विराम चिह्नों को सामान्य पाठ के रूप में मानें; HTML संस्थाओं को डबल-कोडिंग से बचें।
• अंतर्राष्ट्रीयकरण: प्रतिक्रिया भाषा नमूनों के अनुसार अंग्रेजी है। यदि आप स्थानीयकरण करते हैं, तो अपनी ओर से अनुवाद करें।

एंड-टू-एंड वर्कफ़्लो: इनपुट को सत्यापित करना, फिर सामग्री प्राप्त करना

ज्योतिष का अनुरोध करने से पहले, Get Symbols के खिलाफ इनपुट को मान्य करें ताकि अमान्य सूर्य राशियों या असमर्थित समय सीमाओं को रोका जा सके। एक सरल प्रवाह:

1. स्टार्टअप पर एक बार Get Symbols कॉल करें और सूर्य राशियों/समय सीमाओं को मेमोरी में स्टोर करें।
2. उपयोगकर्ता चयन को उन ऐरे के खिलाफ मान्य करें।
3. मान्य इनपुट के साथ ज्योतिष प्राप्त करें या दिनांक द्वारा कॉल करें।

उदाहरण मान्यता तर्क (छद्म-चरण):

• symbols.sunSigns.includes(userSign.toLowerCase())
• symbols.timeFrames.includes(userFrame.toLowerCase())

यदि आप ऐतिहासिक पढ़ाई का समर्थन करते हैं, तो मान्य तिथियों को ISO स्ट्रिंग्स (YYYY-MM-DD) के रूप में स्टोर करें और उन्हें दिनांक द्वारा ठीक उसी तरह पास करें जैसा कि नमूना अनुरोध में दिखाया गया है।

व्यावहारिक उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं

• ऑनबोर्डिंग व्यक्तिगतकरण: खाता निर्माण पर उपयोगकर्ता की सूर्य राशि के लिए पूछें। उनकी प्राथमिकता को स्टोर करें और डैशबोर्ड में दैनिक या साप्ताहिक सामग्री दिखाएं।
• ईमेल या पुश डाइजेस्ट: सभी उपयोगकर्ताओं के लिए सूर्य राशि द्वारा समूहित एक बार-दिन का डाइजेस्ट उत्पन्न करें। कॉल को कम रखने के लिए सूर्य राशि/समय सीमा के अनुसार प्रतिक्रियाओं को कैश करें, फिर सूचनाओं को फैलाएं।
• चैट विजेट और सहायक: जब कोई उपयोगकर्ता "आज के लिए जेमिनी" के लिए पूछता है, तो समय सीमा=daily के साथ ज्योतिष प्राप्त करें और चैट में ज्योतिष फ़ील्ड को स्ट्रीम करें।
• ऐतिहासिक तुलना: उपयोगकर्ताओं को एक पिछले दिनांक का चयन करने दें और इसे आज के साथ तुलना करने दें, पुराने प्रविष्टि के लिए दिनांक द्वारा और वर्तमान के लिए ज्योतिष प्राप्त करें।
• संपादकीय मॉड्यूल: एक CMS ब्लॉक बनाएं जो शुक्रवार को समय सीमा=वीकेंड का चयन करता है ताकि बिना मैनुअल अपडेट के प्रासंगिक सामग्री प्रदर्शित की जा सके।

cURL त्वरित प्रारंभ जिन्हें आप कॉपी कर सकते हैं

प्रतीक प्राप्त करें (अनुशंसित पहला कॉल)

ज्योतिष प्राप्त करें (दैनिक जेमिनी)

दिनांक द्वारा (2024-01-02 को जेमिनी)

AI एजेंट से MCP के माध्यम से ज्योतिष API को कॉल करें

यदि आप MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) में संकेत या उपकरणों का आयोजन कर रहे हैं, तो आप MCP एंडपॉइंट के माध्यम से ज़ाइला APIs को उपकरणों के रूप में कॉल कर सकते हैं। अपने एजेंट को इस पर इंगित करें:

एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

वहां से, आपका एजेंट बैकग्राउंड में समान हब पथ और प्राधिकरण अर्थशास्त्र का उपयोग करके ज्योतिष API को सक्रिय कर सकता है। सेटअप विवरण के लिए, MCP दस्तावेज़ देखें। यह दृष्टिकोण आपकी API कुंजी को केंद्रीकृत रखता है और आपके एजेंट को बिना कस्टम HTTP गोंद के कई ज़ाइला APIs के बीच एकीकृत करने की अनुमति देता है।

संचालनात्मक मार्गदर्शन और गोटचास

• सदस्यता मॉडल: ज़ाइला सदस्यता + कोटा का उपयोग करता है, प्रति कॉल भुगतान नहीं। पहला API आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। हमेशा वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
• कोई मुफ्त योजना नहीं: उत्पादन के लिए, आपको एक सक्रिय सदस्यता की आवश्यकता होगी। अपने कोड में कोटा समाप्ति को संभालें और धीरे-धीरे गिरें (जैसे, कैश की गई सामग्री या एक तटस्थ संदेश)।
• Idempotence: GET कॉल अस्थायी नेटवर्क विफलताओं पर पुनः प्रयास करने के लिए सुरक्षित हैं। यदि आप पुनः प्रयास लागू करते हैं तो गुणात्मक बैकऑफ और एक छोटा जिटर पर विचार करें।
• समय सीमाएँ: प्रतीकों एंडपॉइंट मान्य मानों की सूची देता है जैसे दैनिक, साप्ताहिक, मासिक, और सप्ताह के दिन। वैकल्पिक मानों (जैसे, "आज" या "कल") को मान लें जब तक कि प्रतीकों द्वारा सूचीबद्ध न हो।
• तिथि प्रारूप: दिनांक द्वारा, ISO तिथि स्ट्रिंग (YYYY-MM-DD) पास करें जैसा कि दिखाया गया है। स्थानीय-विशिष्ट प्रारूपों से बचें।
• सामग्री मॉडरेशन: ज्योतिष फ़ील्ड सामान्य पाठ है। यदि आपके ऐप में सामग्री नीतियाँ हैं, तो अपनी ओर से मॉडरेट या फ़िल्टर करें।

आप इस API और हजारों अन्य को कहां पा सकते हैं

ज्योतिष API ज़ाइला पर वित्त, डेटा समृद्धि, AI, भू-स्थान, ई-कॉमर्स, और उपयोगिताओं के लिए हजारों अन्य तैयार-से-उपयोग APIs के साथ स्थित है। एक खाता, एक कुंजी, एक सदस्यता मॉडल आपके स्टैक में एकीकरण और बिलिंग को सरल बनाता है। ज्योतिष API पृष्ठ का अन्वेषण करें, फिर अपनी ऐप में संयोजित करने के लिए अतिरिक्त सेवाओं को खोजने के लिए ज़ाइला API हब पर जाएं।

अक्सर पूछे जाने वाले प्रश्न

मैं प्रमाणीकरण कैसे करूं?
हर अनुरोध के साथ हेडर Authorization: Bearer YOUR_API_KEY भेजें जो ऊपर दिखाए गए हब URLs के लिए है।

कौन सी सूर्य राशियाँ और समय सीमाएँ समर्थित हैं?
प्रतीक प्राप्त करें। यह सूर्य राशियों और समय सीमाओं के लिए ऐरे लौटाता है जिन्हें आप ज्योतिष प्राप्त करें या दिनांक द्वारा कॉल करने से पहले इनपुट को मान्य करने के लिए उपयोग कर सकते हैं।

क्या मैं किसी विशिष्ट तिथि का ज्योतिष प्राप्त कर सकता हूं?
हाँ। दिनांक द्वारा एंडपॉइंट का उपयोग करें जिसमें सूर्य राशि और तिथि (YYYY-MM-DD) ठीक उसी तरह हो जैसा कि प्रलेखित है।

मुझे प्रतिक्रियाओं को कैश कैसे करना चाहिए?
सूर्य राशि और समय सीमा के अनुसार कैश करें। दैनिक सामग्री को एक दिन के लिए कैश किया जा सकता है, साप्ताहिक को एक सप्ताह के लिए, मासिक को एक महीने के लिए। दिनांक द्वारा, अपरिवर्तनीय अतीत की तिथियों के लिए अनिश्चितकाल के लिए कैश करें।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। आपका पहला API आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

क्या आप इसे अपने ऐप में लागू करने के लिए तैयार हैं? अपना ज़ाइला खाता बनाएं, एक API कुंजी प्राप्त करें, और ऊपर दिखाए गए एंडपॉइंट्स को कुछ ही मिनटों में हिट करें। अब पंजीकरण करें और निर्माण शुरू करें।