يوم 0
إثبات الوصول
أنشئ المفتاح، أكمل طلباً واحداً موثقاً، واحفظ الاستجابة الأولى مع بياناتها الوصفية.
فتح الخطوة ←دليل سير عمل API
ماذا تريد أن تبني؟
اختر النتيجة الأقرب لوظيفتك. يمنحك كل مسار طلباً واحداً للعمل، وما يجب أن تحتويه الاستجابة، وكيفية التحقق من عمله، والخطوة المفيدة التالية.
خمسة مسارات عملية
ابدأ بالنتيجة، وليس بقائمة نقاط النهاية.
Selected: Troubleshoot a request
المسار 1
جلب بيانات الاقتصاد الكلي
استرجع سلسلة زمنية نظيفة واحتفظ بالبيانات الوصفية للمصدر والجودة بجانبها.
المسار 2
تخطيط وظائف الإصدار
استخدم تقويم الإصدار لتشغيل مهام مستهدفة حول أوقات النشر المعروفة.
المسار 3
قياس المفاجآت
دمج التوقعات قبل الإصدار مع القيمة المنشورة دون إدخال تحيز الاستشراف المستقبلي.
المسار 4
تلقي تحديثات مباشرة
استخدم SSE كإشارة إبطال، ثم قم بجلب السجل الكامل من REST.
مسار 5
بناء نموذج اقتصاد كلي
حول مجموعة صغيرة من المؤشرات ذات الصلة إلى بطاقة أداء عملات مصنفة حسب المصدر.
تجربة API لمدة 14 يوم الخاصة بك
انتقل من مجرد الطلب الأول إلى مهمة تستحق الاستمرار.
الهدف ليس زيارة كل صفحة منتج. الهدف هو إكمال عمل API مفيد وموثق، والعودة في يوم آخر، والمغادرة مع مجموعة بيانات أو سير عمل تطبيق قابل للتكرار.
أيام 1-2
اجعل الطلب موثوقاً
حل مشكلات المصادقة أو التصفية وحوّل أول سكربت إلى وظيفة مكررة مسمى.
فتح الخطوة ←أيام 3-4
إضافة توقيت الإصدار
استخدم التقويم كعائلة نقاط نهاية ثانية وجدول تشغيل API المفيد التالي.
فتح الخطوة ←أيام 5-7
بناء مخرجات البحث
أضف التوقعات أو مجموعة صغيرة من السلاسل الكلية، ثم قم بإنشاء مقارنة واحدة أو جدول أو بطاقة أداء محفوظة.
فتح الخطوة ←أيام 8-10
أتمتة التحديثات
اختر REST المجدول، أو SSE، أو webhooks وأكمل تشغيل API ناجح آخر في يوم مختلف.
فتح الخطوة ←أيام 11-13
تحصين العميل
أضف مهلات زمنية، وإعادة محاولات محدودة، والتحقق من صحة الاستجابة، وتسجيل البيانات الآمن للمؤهلات، ومراقبة البيانات القديمة.
فتح الخطوة ←يوم 14
مراجعة الأدلة
تأكد من أن API يوفر وظيفة قابلة للتكرار سيحتفظ بها فريقك، ثم اختر مجموعة البيانات التالية أو سير عمل التطبيق.
فتح الخطوة ←Request help
تشخيص استجابة فاشلة أو فارغة
Inspect the status and a short error body, then follow the matching fix. Never paste an API key or a full authenticated URL into a support message.
مثال عملي
احتفظ بمفتاحك في FXMD_API_KEY; لا تقم أبداً بلصقها في نظام التحكم في المصدر.
import os
import requests
key = os.getenv("FXMD_API_KEY", "").strip()
if not key:
raise RuntimeError("FXMD_API_KEY is not set")
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": key, "limit": 1},
timeout=20,
)
print(response.status_code, response.text[:300])النتيجة المتوقعة: A 200 confirms the key and path work. A 401 or 403 points to authentication or access, a 404 to the path, and a 429 to request pacing.
عندما يصبح السكربت الأول نظاماً حقيقياً
استكشاف الأخطاء وإصلاحها وإرشادات الإنتاج
استخدم هذه الأدلة عندما يفشل الرد، أو لا يعيد أي بيانات، أو يحتاج إلى ضوابط الإنتاج مثل التخزين المؤقت، ومهلات الانتظار، وإعادة المحاولة، وتسليم الأحداث.
| دليل | استخدمه عندما | ابدأ |
|---|---|---|
| تشخيص استجابة فاشلة أو فارغة | فصل مشكلات المصادقة، والوصول، والمسار، وتحديد معدل الطلبات، وتوافر البيانات دون الكشف عن مفتاحك. | فتح الدليل ← |
| اجعل عميل API جاهزاً للإنتاج | أضف مهلات زمنية، وإعادة محاولات محدودة، وتخزين مؤقت، وطلبات مشروطة، ونمط التسليم الصحيح. | فتح الدليل ← |