दिन 0
एक्सेस सिद्ध करें
कुंजी बनाएं, एक प्रमाणित अनुरोध पूरा करें, और पहले रिस्पॉन्स को उसके मेटाडेटा के साथ सहेजें।
चरण खोलें →API वर्कफ़्लो गाइड
आप क्या बनाना चाहते हैं?
अपने काम के सबसे करीब परिणाम चुनें। प्रत्येक पाथ आपको एक वर्किंग अनुरोध, प्रतिक्रिया में क्या होना चाहिए, यह कैसे जांचें कि यह काम कर रहा है, और अगला उपयोगी कदम देता है।
पाँच व्यावहारिक मार्ग
परिणाम से शुरू करें, एंडपॉइंट सूची से नहीं।
चयनित: मैक्रो डेटा प्राप्त करें
पाथ 1
मैक्रो डेटा प्राप्त करें
एक स्वच्छ टाइम सीरीज़ प्राप्त करें और उसके साथ स्रोत और गुणवत्ता मेटाडेटा रखें।
पाथ 2
रिलीज़ जॉब्स की योजना बनाएं
ज्ञात प्रकाशन समय के आसपास लक्षित जॉब चलाने के लिए रिलीज़ कैलेंडर का उपयोग करें।
पाथ 3
सरप्राइज़ मापें
लुकअहेड बायस पेश किए बिना प्री-रिलीज़ फोरकास्ट को प्रकाशित वैल्यू के साथ जोड़ें।
पाथ 4
लाइव अपडेट प्राप्त करें
अमान्य (invalidation) सिग्नल के रूप में SSE का उपयोग करें, फिर REST से पूरा रिकॉर्ड प्राप्त करें।
पाथ 5
एक मैक्रो मॉडल बनाएं
संबंधित इंडिकेटर्स के एक छोटे समूह को सोर्स-लेबलled करेंसी स्कोरकार्ड में बदलें।
आपका 14-दिवसीय API परीक्षण
पहले अनुरोध से एक ऐसे कार्य की ओर बढ़ें जो बनाए रखने योग्य हो।
लक्ष्य हर प्रोडक्ट पेज पर जाना नहीं है। लक्ष्य उपयोगी प्रमाणित API कार्य पूरा करना, दूसरे दिन वापस आना, और एक दोहराने योग्य डेटासेट या एप्लिकेशन वर्कफ़्लो के साथ जाना है।
दिन 1-2
अनुरोध को भरोसेमंद बनाएं
ऑथेंटिकेशन या फ़िल्टर समस्याओं को हल करें और पहले स्क्रिप्ट को एक नामित दोहराने योग्य जॉब में बदलें।
चरण खोलें →दिन 3-4
रिलीज़ टाइमिंग जोड़ें
कैलेंडर को दूसरे एंडपॉइंट परिवार के रूप में उपयोग करें और अगला उपयोगी API रन शेड्यूल करें।
चरण खोलें →दिन 5-7
रिसर्च आउटपुट बनाएं
अपेक्षाएं या मैक्रो सीरीज़ का एक छोटा समूह जोड़ें, फिर एक सहेजा गया तुलना, तालिका, या स्कोरकार्ड बनाएं।
चरण खोलें →दिन 8-10
अपडेट स्वचालित करें
अनुसूचित REST, SSE, या वेबहुक चुनें और किसी अन्य दिन एक और सफल API रन पूरा करें।
चरण खोलें →दिन 11-13
क्लाइंट को मजबूत बनाएं
टाइमआउट, बाउंडेड रिट्राइज़, रिस्पॉन्स वैलिडेशन, क्रेडेंशियल-सेफ लॉगिंग और स्टेल-डेटा मॉनिटरिंग जोड़ें।
चरण खोलें →दिन 14
साक्ष्य की समीक्षा करें
पुष्टि करें कि API एक दोहराने योग्य जॉब प्रदान करता है जिसे आपकी टीम बनाए रखेगी, फिर अगला डेटासेट या एप्लिकेशन वर्कफ़्लो चुनें।
चरण खोलें →पहला अनुरोध
मैक्रो इतिहास प्राप्त करें और सहेजें
एक मुद्रा और संकेतक से शुरू करें जिसे आप पहले से समझते हैं। यह अधिक सीरीज़ जोड़ने से पहले प्रमाणीकरण, रिस्पॉन्स शेप, पेजिनेशन और स्टोरेज को सत्यापित करना आसान बनाता है।
कार्यकारी उदाहरण
अपनी की (key) को इसमें रखें FXMD_API_KEY; इसे कभी भी सोर्स कंट्रोल में पेस्ट न करें।
import os
import requests
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])अपेक्षित परिणाम: हाल के EUR मुद्रास्फीति अवलोकनों के साथ एक 200 रिस्पॉन्स और रिस्पॉन्स मेटाडेटा जो सीरीज, स्रोत, पेजिनेशन और डेटा गुणवत्ता का वर्णन करता है।
जब पहला स्क्रिप्ट एक वास्तविक सिस्टम बन जाता है
ट्रबलशूटिंग और प्रोडक्शन मार्गदर्शन
जब कोई प्रतिक्रिया विफल हो जाती है, कोई डेटा नहीं लौटाती है, या कैशिंग, टाइमआउट, रिट्राइज़ और इवेंट डिलीवरी जैसे प्रोडक्शन नियंत्रणों की आवश्यकता होती है, तो इन गाइडों का उपयोग करें।
| गाइड | इसका उपयोग तब करें जब | शुरू करें |
|---|---|---|
| विफल या खाली रिस्पॉन्स का निदान करें | अपनी की (key) को उजागर किए बिना प्रमाणीकरण, एक्सेस, पाथ, रेट-लिमिट और डेटा-उपलब्धता की समस्याओं को अलग करें। | गाइड खोलें → |
| API क्लाइंट को प्रोडक्शन-रेडी बनाएं | टाइमआउट, बाउंडेड रिट्राइज़, कैशिंग, कंडीशनल रिक्वेस्ट, और सही डिलीवरी पैटर्न जोड़ें। | गाइड खोलें → |