مراقب التضخم
تتبع التضخم الرئيسي والأساسي لـ US جنباً إلى جنب مع EUR/USD.
فتح سير العملدليل سير عمل API
ماذا تريد أن تبني؟
ابدأ بسير عمل بحثي وجدول بيانات، أو اتبع دليل API لبناء تطبيقك الخاص.
Choose your next step
Put macro data to work.
- Research an economy. Explore the country pages, check series coverage, then build a research workbook.
- Research with an AI assistant. Follow the MCP setup guide, choose a question from the prompt library, and keep the reported units, dates and source links with your answer.
- Build a product for your audience. Explore the customer showcase و example applications, run your first API request, then review display rights and attribution.
ابدأ بسير عمل بحثي
اختر نقطة البداية، وراجع الأدلة، واحتفظ بدفتر عمل يمكنك إعادة بنائه.
مقارنة سياسة البنك المركزي
قارن بين أسعار سياسة US ومنطقة اليورو إلى جانب EUR/USD.
فتح سير العملمراجعة الإصدار والمراجعة
فحص إصدارات تضخم US المحتفظ بها، والقيم، وأدلة النشر.
فتح سير العملتحقق من التغطية قبل اختيار خطة. هل تستخدم بالفعل تكاملاً مع جداول البيانات؟ اتبع دليل Excel أو دليل Google Sheets للوظائف المدعومة وسلوك التحديث.
هل تقوم بتقييم API؟ فحص عينة المطور التاريخية المقيدة وحقول الاستجابة الخاصة بها.
خمسة مسارات عملية
ابدأ بالنتيجة، وليس بقائمة نقاط النهاية.
Selected: Harden a client
المسار 1
جلب بيانات الاقتصاد الكلي
استرجع سلسلة زمنية نظيفة واحتفظ بالبيانات الوصفية للمصدر والجودة بجانبها.
المسار 2
تخطيط وظائف الإصدار
استخدم تقويم الإصدار لتشغيل مهام مستهدفة حول أوقات النشر المعروفة.
المسار 3
قياس المفاجآت
دمج التوقعات قبل الإصدار مع القيمة المنشورة دون إدخال تحيز الاستشراف المستقبلي.
المسار 4
تلقي تحديثات مباشرة
استخدم SSE كإشارة إبطال، ثم قم بجلب السجل الكامل من REST.
مسار 5
بناء نموذج اقتصاد كلي
حول مجموعة صغيرة من المؤشرات ذات الصلة إلى بطاقة أداء عملات مصنفة حسب المصدر.
تجربة API لمدة 14 يوم الخاصة بك
انتقل من مجرد الطلب الأول إلى مهمة تستحق الاستمرار.
الهدف ليس زيارة كل صفحة منتج. الهدف هو إكمال عمل API مفيد وموثق، والعودة في يوم آخر، والمغادرة مع مجموعة بيانات أو سير عمل تطبيق قابل للتكرار.
يوم 0
إثبات الوصول
أنشئ المفتاح، أكمل طلباً واحداً موثقاً، واحفظ الاستجابة الأولى مع بياناتها الوصفية.
فتح الخطوة ←أيام 1-2
اجعل الطلب موثوقاً
حل مشكلات المصادقة أو التصفية وحوّل أول سكربت إلى وظيفة مكررة مسمى.
فتح الخطوة ←أيام 3-4
إضافة توقيت الإصدار
استخدم التقويم كعائلة نقاط نهاية ثانية وجدول تشغيل API المفيد التالي.
فتح الخطوة ←أيام 5-7
بناء مخرجات البحث
أضف التوقعات أو مجموعة صغيرة من السلاسل الكلية، ثم قم بإنشاء مقارنة واحدة أو جدول أو بطاقة أداء محفوظة.
فتح الخطوة ←أيام 8-10
أتمتة التحديثات
اختر REST المجدول، أو SSE، أو webhooks وأكمل تشغيل API ناجح آخر في يوم مختلف.
فتح الخطوة ←أيام 11-13
تحصين العميل
أضف مهلات زمنية، وإعادة محاولات محدودة، والتحقق من صحة الاستجابة، وتسجيل البيانات الآمن للمؤهلات، ومراقبة البيانات القديمة.
فتح الخطوة ←يوم 14
مراجعة الأدلة
تأكد من أن API يوفر وظيفة قابلة للتكرار سيحتفظ بها فريقك، ثم اختر مجموعة البيانات التالية أو سير عمل التطبيق.
فتح الخطوة ←Production readiness
اجعل عميل API جاهزاً للإنتاج
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
مثال عملي
احتفظ بمفتاحك في FXMD_API_KEY; لا تقم أبداً بلصقها في نظام التحكم في المصدر.
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"limit": 5},
headers={"X-API-Key": os.environ["FXMD_API_KEY"], "Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()النتيجة المتوقعة: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
عندما يصبح السكربت الأول نظاماً حقيقياً
استكشاف الأخطاء وإصلاحها وإرشادات الإنتاج
استخدم هذه الأدلة عندما يفشل الرد، أو لا يعيد أي بيانات، أو يحتاج إلى ضوابط الإنتاج مثل التخزين المؤقت، ومهلات الانتظار، وإعادة المحاولة، وتسليم الأحداث.
| دليل | استخدمه عندما | ابدأ |
|---|---|---|
| تشخيص استجابة فاشلة أو فارغة | فصل مشكلات المصادقة، والوصول، والمسار، وتحديد معدل الطلبات، وتوافر البيانات دون الكشف عن مفتاحك. | فتح الدليل ← |
| اجعل عميل API جاهزاً للإنتاج | أضف مهلات زمنية، وإعادة محاولات محدودة، وتخزين مؤقت، وطلبات مشروطة، ونمط التسليم الصحيح. | فتح الدليل ← |